このページは Cloud Translation API によって翻訳されました。

払い戻す

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。詳細

はじめに

収益化により、「購入取引」に対してデベロッパーに払い戻しを行うことができます。たとえば、通信事業者であり、モバイルサブスクライバーに料金を支払う決済 API をデベロッパーに提供します。アプリケーションまたはアプリ内のコンテンツの購入。サブスクライバーが API を使用するたび購入は購入取引に該当します

購入取引では払い戻しが行われることがあります。たとえば、コンテンツが配信されない、またはその他の点でサードパーティが購入に満足していない。その場合、デベロッパーはサードパーティに払い戻しを行います。収益化では、類似の払い戻しを行うことができます。これは、特に収益分配計画に関連する事項です

モバイル定期購入者に払い戻しを行ったデベロッパーが収益を購入したとします。 API プロダクトの共有プランを作成します。このプランで、開発者が契約期間の 70% を受け取ると仮定します。購入取引の正味価格/総額。払い戻しを行うと、事実上、購入取引の場合は、デベロッパーへの支払い額からその月の 70% が差し引かれます払い戻しが適用された月（実際に請求された月とは異なる場合があります）発生した場合）。

Classic Edge UI を使用して払い戻しを送信する（Edge for Private Cloud のみ）

「正常に完了」した商品に対し、つまり、API 呼び出しが未請求の第三者への請求が正常に行われており、します。払い戻しを行うと、親と払い戻しトランザクションが作成されます。取引 ID: 購入取引の ID。

元の購入取引の全額、または提供します。一部払い戻しを複数回行うこともできますが、払い戻しの合計額は当初の購入額を超える金額は指定できません。

払い戻しを投稿するには:

[収益受け取り] タブで [払い戻し] を選択します。

[Refunds] ページが開きます。
[請求月] プルダウンメニューで、購入取引が発生した月を選択します。行ったことになります。[+ 払い戻し] をクリックします。
選択した商品の正常な購入取引の一覧が表示されるあります。

払い戻しリストはデベロッパー名でフィルタすることも、実際のあります。

デベロッパーでフィルタするには、[Developer] プルダウンメニューからデベロッパーを選択します。この選択したデベロッパーに関連するトランザクションのみのリストが表示されます。

取引 ID でフィルタするには、元の購入の取引 ID を入力します。払い戻しを希望する。これにより、その ID のトランザクションが返されます。
払い戻しを行うトランザクションの行にある [選択] チェックボックスをオンにします。
[タイプ] プルダウンメニューで [合計] または [一部] を選択します。
[合計] を選択した場合は、購入の全額が払い戻されます。[ 一部（購入額の一部）が払い戻されます。

一部を選択した場合は、一部払い戻しの金額を [金額] フィールドに入力します。Google Chat では購入総額を上限として払い戻されます。コンテンツの一部分をすでに投稿している場合は、入力できるのは、購入の残額までです。また、元の購入取引に総額と正味価格の両方がある場合は、一部払い戻しの対象が総額か純額か。
[保存] をクリックして払い戻しを処理するか、[キャンセル] をクリックしてキャンセルします。
請求月がまだ適用されていない場合、払い戻しは元の購入月に対して行われます。それ以外の場合は、現在の日付に払い戻しが計上されます。

一部払い戻しの場合は、一部と収益分配について払い戻しが処理されます。全額に対する一部額がの割合に基づいて差し引かれます。上記の一部払い戻しの場合、部分的な金額は 0.50÷1.12 = 総額の 45% になるため、デベロッパーの収益分配の 45% が差し引かれます。

UI で払い戻しが行われたかどうかの確認処理済み

上部の請求月を選択すると、払い戻しが処理されたかどうかを判断できます。 [Refunds] ページをご覧ください。請求月がまだオープンの場合、または当月が終了している場合はこのページには、Google が現在実施したすべての払い戻しが。

API を使用して払い戻しを投稿する

払い戻しを送信するには、POST リクエストを /organizations/{org_name}/monetization-packages/{package_id}/refund-transactions, ここで、{package_id} は払い戻し先の API パッケージの ID です。適用されます。

リクエストを発行するときは、次のクエリパラメータとして指定する必要があります。

払い戻しの対象となる購入取引の ID。
購入トランザクションの収益タイプ（GROSS または NET）。
払い戻し額。
払い戻しの理由を説明したメモ。

払い戻し先の API パッケージを URL パラメータとして指定することもできます。適用されます。

URL の完全なリストについては、払い戻しの構成設定をご覧ください。 2 つのパラメータがあります。

たとえば、次のリクエストでは購入トランザクションの払い戻しを行います。払い戻し購入取引の総金額の 50% である。

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/refund-transactions?revenueType=GROSS&refundAmount=0.5&parentTxId=abf50909-2492-4bf5-8704-ade05f4d43b3&transactionNote=Refund for purchase transaction" \
-u email:password

レスポンスは次のようになります（レスポンスの一部のみが表示されています）。

{
  "application" : {
    ...
    },
    "product" : [ {
      ...
      
     {
      "customAtt1Name" : "user",
      "description" : "Payment",
      "displayName" : "Payment",
      "id" : "payment",
      "name" : "payment",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    } ],
    ...
  },
  "currency" : "USD",
  "developer" : {
    ...
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
      ...
    },
    ...
  },
  "endTime" : "2013-09-01 21:59:59",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8123,
  "gbpExchangeRate" : 0.6910,
  "grossPrice" : 0.5,
  "id" : "61f7eb88-f8cc-4cda-afd8-4a61fba3dd33",
  "isRevOnGrossOrNet" : "NET",
  "isVirtualCurrency" : false,
  "notes" : "Refund for purchase transaction",
  "itemDesc" : "test application",
  "netPrice" : 0.4464,
  "orgRevenueShareAmount" : 0.1339,
  "parentId" : "abf50909-2492-4bf5-8704-ade05f4d43b3",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  ...
  },
  "ratePlanLevel" : "STANDARD",
  "revenueShareAmount" : 0.3125,
  "startTime" : "2013-09-01 21:59:59",
  "status" : "SUCCESS",
  "tax" : 0.0536,
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "REFUND",
  "usdExchangeRate" : 1.0724,
  "utcEndTime" : "2013-09-01 21:59:59",
  "utcStartTime" : "2013-09-01 21:59:59"
}

API の払い戻し構成設定

払い戻しリクエストでは、次のクエリパラメータを指定できます。

名前	説明	デフォルト	必須
`monetizationPackageId`	払い戻しが適用される API パッケージ。	なし	いいえ
`parentTxId`	払い戻しの対象となる購入取引。	なし	○
`revenueType`	購入の収益タイプ（`GROSS` または `NET`）あります。	なし	○
`refundAmount`	払い戻し額。	なし	○
`transactionNote`	払い戻しの理由を説明するテキストメモ。	なし	○

次のステップ

収益化関連のジョブのスケジュール方法とスケジュールされるジョブについて学習する [スケジュール] に収益化ジョブ