---
title: 返金を管理する
url: ja/amazon-pay-paymentmethodonfile-setupintent/ja-manage-refunds.html
---

**[ステップ5/7]** 返金の実行に有効期限はありません。返金は<a href="../amazon-pay-api-v2/refund.md#create-refund" target="_blank" rel="noopener noreferrer">Create Refund</a>を利用するか、Amazon Pay事業者のアカウント管理ツールの<a href="http://sellercentral.amazon.com/" target="_blank" rel="noopener noreferrer">セラーセントラル</a>を通してマニュアルで実行することができます。Amazon Payは、返金が正常に処理された後に購入者に通知を行います。詳細については、<a href="../amazon-pay-checkout/buyer-communication.md" target="_blank" rel="noopener noreferrer">購入者とのコミュニケーション</a>をご覧ください。

このステップでは、APIを介して返金を発行する機能を追加します。このステップの最後に、全額または一部の返金を発行し、返金のステータスを確認できるようになります。

<!-- <div style="display:none" class="environmentSpecificKeys">
  <div markdown="span" class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> publicKeyIdの先頭に環境名が<b>付与されていない</b>場合 (SANDBOX'や'LIVE'で始まっていない場合)、<a href='#' onclick='window.location.href=window.location.href.split("?")[0]+"?environmentSpecificKeys=false"' rel='noopener noreferrer'>こちらの手順</a>を確認してください。</div>
</div>
<div style="display:none" class="notEnvironmentSpecificKeys">
  <div markdown="span" class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> publicKeyIdの先頭に環境名が付与されている場合 (例: SANDBOX-AFVX7ULWSGBZ5535PCUQOY7B)、<a href='#' onclick='window.location.href=window.location.href.split("?")[0]+"?environmentSpecificKeys=true"' rel='noopener noreferrer'>こちらの手順</a>を確認してください。</div>
</div> -->

* TOC
{:toc}
{::options toc_levels="3" /}

***

### 1. 返金の実行

<a href="../amazon-pay-api-v2/refund.md#create-refund" target="_blank" rel="noopener noreferrer">Create Refund</a>を実行し、売上請求済みのChargeに対して、全額または一部の返金を行います。また、（事業者の裁量によって）購入者に過大な補償を行い、元の売上請求額より15％または75 USD / GBP / EUR、8,400円のいずれか少ない金額を追加して返金することもできます。

#### リクエスト


<div style="display:none" class="environmentSpecificKeys">
<code style="color:black">
curl "https://pay-api.amazon.com/:version/refunds/" \ <br />
-X POST<br />
-H "authorization:Px2e5oHhQZ88vVhc0DO%2FsShHj8MDDg%3DEXAMPLESIGNATURE"<br />
-H "x-amz-pay-date:20201012T235046Z"<br />
-H "x-amz-pay-idempotency-key:AVLo5tI10BHgEk2jEXAMPLEKEY"<br />
-d @request_body<br />
</code>
</div>
<div style="display:none" class="notEnvironmentSpecificKeys">
<code style="color:black">
curl "https://pay-api.amazon.com/:environment/:version/refunds/" \ <br />
-X POST<br />
-H "authorization:Px2e5oHhQZ88vVhc0DO%2FsShHj8MDDg%3DEXAMPLESIGNATURE"<br />
-H "x-amz-pay-date:20201012T235046Z"<br />
-H "x-amz-pay-idempotency-key:AVLo5tI10BHgEk2jEXAMPLEKEY"<br />
-d @request_body<br />
</code>
</div>

#### リクエストボディ

```
{
    "chargeId": "CHARGE_ID",
    "refundAmount": {
        "amount": "14.00",
        "currencyCode": "USD"
    },
    "softDescriptor": "Descriptor"
}
```


#### リクエストパラメータ

<table width="100%" border="1">
    <tbody>
        <tr id='PDP9CAmKLQf'>
            <td id='s:PDP9CAmKLQf;PDP9CA2olcO' style='vertical-align: top; font-weight: bold; width: 30%;' class='bold'>名前
                <br /></td>
            <td id='s:PDP9CAmKLQf;PDP9CATyPvC' style='vertical-align: top; font-weight: bold; width: 20%;' class='bold'>ロケーション
                <br /></td>
            <td id='s:PDP9CAmKLQf;PDP9CAwX3Nj' style='vertical-align: top; font-weight: bold; width: 50%;' class='bold'>説明
                <br /></td>
        </tr>
        <tr id='PDP9CAnivE7'>
            <td id='s:PDP9CAnivE7;PDP9CA2olcO' style='vertical-align: top;'>x-amz-pay-idempotency-key<br><b>(必須)</b><br><br>Type: string
                <br /></td>
            <td id='s:PDP9CAnivE7;PDP9CATyPvC' style='vertical-align: top;'>Header
                <br /></td>
            <td id='s:PDP9CAnivE7;PDP9CAwX3Nj' style='vertical-align: top;'>要求を安全に再試行するための<a href="../amazon-pay-api-v2/idempotency.md" target="_blank" rel="noopener noreferrer">冪等キー</a>
                <br /></td>
        </tr>
        <tr id='PDP9CAeT5BG'>
            <td id='s:PDP9CAeT5BG;PDP9CA2olcO' style='vertical-align: top;'>chargeId<br><b>(必須)</b><br><br>Type: string
                <br /></td>
            <td id='s:PDP9CAeT5BG;PDP9CATyPvC' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:PDP9CAeT5BG;PDP9CAwX3Nj' style='vertical-align: top;'>Charge識別子
                <br /></td>
        </tr>
        <tr id='PDP9CAkSeaD'>
            <td id='s:PDP9CAkSeaD;PDP9CA2olcO' style='vertical-align: top;'>refundAmount<br><b>(必須)</b><br><br>Type: <a target="_blank" rel="noopener noreferrer" href="../amazon-pay-api-v2/refund.md#type-price">price</a>
                <br /></td>
            <td id='s:PDP9CAkSeaD;PDP9CATyPvC' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:PDP9CAkSeaD;PDP9CAwX3Nj' style='vertical-align: top;'>売上請求額の15%か75 USD/GBP/EUR/8,400円のどちらか低い額まで増額した額までです。<br><br> 最大値: 150,000 USD/GBP/EUR または 10,000,000 JPY
                <br /></td>
        </tr>
        <tr id='PDP9CATP71V'>
            <td id='s:PDP9CATP71V;PDP9CA2olcO' style='vertical-align: top;'>softDescriptor<br><br>Type: string
                <br /></td>
            <td id='s:PDP9CATP71V;PDP9CATyPvC' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:PDP9CATP71V;PDP9CAwX3Nj' style='vertical-align: top;'>説明は、購入者のお支払い方法（銀行など）の明細書に表示されます<br><br><strong>日本では利用できません。固定値が表示されます。</strong><br><br>デフォルト値： "AMZ* &lt;MerchantStoreName&gt; amzn.com/pmts" <br><br>最大長： 16 文字/バイト<br>
                <br /></td>
        </tr>
    </tbody>
</table>


#### レスポンス

```
{
     "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. 返金状況を確認します

<a href="../amazon-pay-api-v2/refund.md#get-refund" target="_blank" rel="noopener noreferrer">Get Refund</a>で返金状況をチェックします。 返金を非同期で処理します。インスタント支払通知（IPN）を設定するか、ポーリングメカニズムを実装して<a href="../amazon-pay-api-v2/refund.md#get-refund" target="_blank" rel="noopener noreferrer">Get Refund</a>に更新を問い合わせます。詳細については、<a href="../amazon-pay-checkout/asynchronous-processing.md" target="_blank" rel="noopener noreferrer">非同期処理</a>を参照してください。

#### Refund状態の説明

<table width="100%" border="1">
    <tbody>
        <tr id='FGN9CAsvAdD'>
            <td id='s:FGN9CAsvAdD;FGN9CAO5JkC' style='vertical-align: top; font-weight: bold; width: 30%;' class='bold'>返金状況
                <br /></td>
            <td id='s:FGN9CAsvAdD;FGN9CAoxq4P' style='vertical-align: top; font-weight: bold; width: 70%;' class='bold'>説明
                <br /></td>
        </tr>
        <tr id='FGN9CAG51CG'>
            <td id='s:FGN9CAG51CG;FGN9CAO5JkC' style='text-align: left;vertical-align: top;'>RefundInitiated
                <br /></td>
            <td id='s:FGN9CAG51CG;FGN9CAoxq4P' style='vertical-align: top;'>返金はまだ処理中です
                <br /></td>
        </tr>
        <tr id='FGN9CAoRKpI'>
            <td id='s:FGN9CAoRKpI;FGN9CAO5JkC' style='text-align: left;vertical-align: top;'>Refunded
                <br /></td>
            <td id='s:FGN9CAoRKpI;FGN9CAoxq4P' style='vertical-align: top;'>返金は成功しました
                <br /></td>
        </tr>
        <tr id='FGN9CAXHecY'>
            <td id='s:FGN9CAXHecY;FGN9CAO5JkC' style='text-align: left;vertical-align: top;'>Declined
                <br /></td>
            <td id='s:FGN9CAXHecY;FGN9CAoxq4P' style='vertical-align: top;'>返金は拒否されました。詳細については、理由コードを確認してください。<br><br><b>AmazonRejected</b> - Amazonへの未払金額があるため、購入者様への返金ができませんでした。別の方法（お客様のショップポイント等）で購入者様への返金を行うか、セラーセントラルからクレジットカードを登録して未払金額を解消した後に、再度返金指示を実施してください。<b><br><br>ProcessingFailure</b> - 内部処理エラーのため、または購入者がAmazonマーケットプレイス保証またはチャージバックからの返金をすでに受け取っているため、Amazonはトランザクションを処理できませんでした。 ChargeオブジェクトがCaptured状態の場合にのみ、返金を再試行する必要があります。それ以外の場合は、別の方法で購入者に返金する必要があります（たとえば、ストアクレジットや小切手）
                <br /></td>
        </tr>
    </tbody>
</table>


#### リクエスト


<div style="display:none" class="environmentSpecificKeys">
<code style="color:black">
curl "https://pay-api.amazon.com/:version/refunds/:refundId" \ <br />
-X GET<br />
-H "authorization:Px2e5oHhQZ88vVhc0DO%2FsShHj8MDDg%3DEXAMPLESIGNATURE"<br />
-H "x-amz-pay-date:20201012T235046Z"<br />
</code>
</div>
<div style="display:none" class="notEnvironmentSpecificKeys">
<code style="color:black">
curl "https://pay-api.amazon.com/:environment/:version/refunds/:refundId" \ <br />
-X GET<br />
-H "authorization:Px2e5oHhQZ88vVhc0DO%2FsShHj8MDDg%3DEXAMPLESIGNATURE"<br />
-H "x-amz-pay-date:20201012T235046Z"<br />
</code>
</div>

#### リクエストパラメータ

<table width="100%" border="1">
    <tbody>
        <tr id='PDP9CAQSM5J'>
            <td id='s:PDP9CAQSM5J;PDP9CAXfdYQ' style='vertical-align: top; font-weight: bold; width: 30%;' class='bold'>名前
                <br /></td>
            <td id='s:PDP9CAQSM5J;PDP9CAkAlRX' style='vertical-align: top; font-weight: bold; width: 20%;' class='bold'>ロケーション
                <br /></td>
            <td id='s:PDP9CAQSM5J;PDP9CAn6CQD' style='vertical-align: top; font-weight: bold; width: 50%;' class='bold'>説明
                <br /></td>
        </tr>
        <tr id='PDP9CAkesJe'>
            <td id='s:PDP9CAkesJe;PDP9CAXfdYQ' style='vertical-align: top;'>refundId<br><b>(必須)</b><br><br>Type: string
                <br /></td>
            <td id='s:PDP9CAkesJe;PDP9CAkAlRX' style='vertical-align: top;'>Path Parameter
                <br /></td>
            <td id='s:PDP9CAkesJe;PDP9CAn6CQD' style='vertical-align: top;'>Refund識別子
                <br /></td>
        </tr>
    </tbody>
</table>

#### レスポンス

```
{
     "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"
}
```