返金を管理する

[ステップ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"
}