返金を管理する
[ステップ6/8] 返金の実行に有効期限はありません。返金はCreate Refundを利用するか、Amazon Pay事業者のアカウント管理ツールのセラーセントラルを通してマニュアルで実行することができます。Amazon Payは、返金が正常に処理された後に購入者に通知を行います。詳細については、購入者とのコミュニケーションをご覧ください。
このステップでは、APIを介して返金を実行する機能を追加します。このステップの最後に、全額または一部の返金を実行し、返金のステータスを確認できるようになります。
1. 返金の実行
Create Refundを実行し、売上請求済みのChargeに対して、全額または一部の返金を行います。また、(事業者の裁量によって)購入者に過大な補償を行い、元の売上請求額より15%または75 USD / GBP / EUR、8,400円のいずれか少ない金額を追加して返金することもできます。
リクエスト
リクエストボディ
{
"chargeId": "CHARGE_ID",
"refundAmount": {
"amount": "14.00",
"currencyCode": "USD"
},
"softDescriptor": "Descriptor"
}
リクエストパラメータ
名前
|
ロケーション
|
説明
|
x-amz-pay-idempotency-key (必須) Type: string |
Header
|
要求を安全に再試行するための冪等キー
|
chargeId (必須) Type: string |
Body
|
Charge識別子
|
refundAmount (必須) Type: price |
Body
|
売上請求額の15%か75 USD/GBP/EUR/8,400円のどちらか低い額まで増額した額までです。 最大値: 150,000 USD/GBP/EUR または 10,000,000 JPY |
softDescriptor Type: string |
Body
|
説明は、購入者のお支払い方法(銀行など)の明細書に表示されます 日本では利用できません。固定値が表示されます。 デフォルト値: "AMZ* <MerchantStoreName> amzn.com/pmts" 最大長: 16 文字/バイト |
レスポンス
{
"refundId": "S01-5105180-3221187-R022311",
"chargeId": "S01-5105180-3221187-C056351",
"refundAmount": {
"amount": "14.00",
"currencyCode": "USD"
},
"softDescriptor": "Descriptor",
"creationTimestamp": "20190714T155300Z",
"statusDetails": {
"state": "RefundInitiated",
"reasonCode": null,
"reasonDescription": null,
"lastUpdatedTimestamp": "20190714T155300Z"
},
"releaseEnvironment": "Sandbox"
}
2. 返金ステータスの確認
Get Refundを実行して、返金のステータスを確認します。Amazon Payは返金を非同期で処理します。インスタント支払い通知(IPN)を設定するか、ポーリングメカニズムを実装して Get Refund APIを実行し、更新を確認します。詳細については、非同期処理をご覧ください。
返金ステータスの説明
Refundステータス
|
説明
|
RefundInitiated
|
返金はまだ処理中です
|
Refunded
|
返金は成功しました
|
Declined
|
返金は拒否されました。詳細については、理由コードを確認してください。: AmazonRejected - Amazonへの未払金額があるため、購入者様への返金ができませんでした。別の方法(お客様のショップポイント等)で購入者様への返金を行うか、セラーセントラルからクレジットカードを登録して未払金額を解消した後に、再度返金指示を実施してください。 ProcessingFailure - 内部処理エラーのため、または購入者がAmazonマーケットプレイス保証、またはチャージバックによる返金をすでに受け取っているため、Amazonはトランザクションを処理できませんでした。CaptureオブジェクトがCompleted状態の場合にのみ、返金をリトライする必要があります。それ以外の場合は、別の方法で購入者に返金する必要があります。(例えば、ストアクレジットや小切手) |
リクエスト
リクエストパラメータ
名前
|
ロケーション
|
説明
|
refundId (必須) Type: string |
Path Parameter
|
Refund識別子
|
レスポンス
{
"refundId": "S01-5105180-3221187-R022311",
"chargeId": "S01-5105180-3221187-C056351",
"refundAmount": {
"amount": "14.00",
"currencyCode": "USD"
},
"softDescriptor": "Descriptor",
"creationTimestamp": "20190714T155300Z",
"statusDetails": {
"state": "Refunded",
"reasonCode": null,
"reasonDescription": null,
"lastUpdatedTimestamp": "20190714T155300Z"
},
"releaseEnvironment": "Sandbox"
}