返金を管理する

[ステップ4/7] 返金の実行に有効期限はありません。返金は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で返金状況をチェックします。 返金を非同期で処理します。インスタント支払通知(IPN)を設定するか、ポーリングメカニズムを実装してGet Refundに更新を問い合わせます。詳細については、非同期処理を参照してください。

Refund状態の説明

返金状況
説明
RefundInitiated
返金はまだ処理中です
Refunded
返金は成功しました
Declined
返金は拒否されました。詳細については、理由コードを確認してください。

AmazonRejected - Amazonは返金を拒否しました。別の方法(ギフトカードやストアクレジットなど)で購入者に返金を行う必要があります

ProcessingFailure
- 内部処理エラーのため、または購入者がAmazonマーケットプレイス保証またはチャージバックからの返金をすでに受け取っているため、Amazonはトランザクションを処理できませんでした。 ChargeオブジェクトがCaptured状態の場合にのみ、返金を再試行する必要があります。それ以外の場合は、別の方法で購入者に返金する必要があります(たとえば、ストアクレジットや小切手)

リクエスト

リクエストパラメータ

名前
ロケーション
説明
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"
}