---
title: 設定されたお支払い方法を用いて支払いを管理する
url: ja/amazon-pay-paymentmethodonfile-setupintent/ja-manage-payments-using-payment-method-on-file.html
---

**[ステップ 4/7]** 購入者がお支払い方法設定の保存を完了すると、<a href="../amazon-pay-paymentmethodonfile/checkout-session.md#complete-checkout-session" target="_blank" rel="noopener noreferrer">Complete Checkout Session</a>のレスポンスに、お支払い方法設定にで生成されたCharge Permissionオブジェクトの`ChargePermissionId`が含まれて返却されます。このIdをもとに購入者への請求とキャンセルの管理に行うことができます。

このステップを完了すると、購入者への請求とキャンセルの管理が可能になります。

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

***

### 1. 請求とオーソリ失敗のハンドリング

購入者に請求する必要がある場合は、毎回 <a href="../amazon-pay-paymentmethodonfile/charge.md#create-charge" target="_blank" rel="noopener noreferrer">Create Charge</a> APIを実行します。`CaptureNow`パラメーターをtrueに設定すると売上請求も同時に実施されます。falseに設定する場合は、別途売上請求処理を実施する必要があります。
注意：Amazon Payでは、各月に購入者に請求できる金額の上限が設定されていることに注意してください。詳細については、<a href="../amazon-pay-checkout/monthly-paymentmethodonfile-charge-limits.md" target="_blank" rel="noopener noreferrer">PaymentMethodOnFileの月額上限</a>を参照してください。

<a href="../amazon-pay-paymentmethodonfile/charge.md#create-charge" target="_blank" rel="noopener noreferrer">Create Charge</a>が201 レスポンスを返却した場合、オーソリは正常に取得されています。`canHandlePendingAuthorization`がtrueの場合は、非同期オーソリのリクエストが正常に受け付けられています。 もし、<a href="../amazon-pay-paymentmethodonfile/charge.md#create-charge" target="_blank" rel="noopener noreferrer">Create Charge</a>がそれ以外のHTTPステータスコードを返却した場合は、以下のようにレスポンスの理由コード(ReasonCode)を確認してCreate Chargeを再試行すべきか購入者に別の支払い方法を利用してもらうべきかを判断します。

* もし `reasonCode` が SoftDeclined または ProcessingFailure の場合、以下のことを行います：
    1. <a href="../amazon-pay-paymentmethodonfile/charge-permission.md#get-charge-permission" target="_blank" rel="noopener noreferrer">Get Charge Permission</a>を実行して、ChargePermissionがChargeableステータスにあることを確認します
    2. <a href="../amazon-pay-paymentmethodonfile/charge.md#create-charge" target="_blank" rel="noopener noreferrer">Create Charge</a>を実行し、購入者への請求を再試行します。

* もし `reasonCode` が HardDeclined がHardDeclinedの場合、次のリンクを使用して支払い方法を更新するように購入者に依頼してください：
https://pay.amazon.com/jp/jr/your-account/ba/{ChargePermissionId}。※{ChargePermissionId}の部分を購入者のPMOF ChargePermissionIdに置き換えます。 支払い方法が​​更新されたら通知を受け取るように<a href="../amazon-pay-paymentmethodonfile/set-up-instant-payment-notifications.md" target="_blank" rel="noopener noreferrer">IPNを設定</a>し、以下のことを行います：
    1. <a href="../amazon-pay-paymentmethodonfile/charge-permission.md#get-charge-permission" target="_blank" rel="noopener noreferrer">Get Charge Permission</a>を実行して、ChargePermissionがChargeableステータスにあることを確認します
    2. <a href="../amazon-pay-paymentmethodonfile/charge.md#create-charge" target="_blank" rel="noopener noreferrer">Create Charge</a>を実行し、購入者への請求を再試行します。

* 上記以外の`reasonCode`だった場合、購入者に連絡し、別の決済方法で再度決済を行ってもらうようご案内します

#### リクエスト

```
curl "https://pay-api.amazon.com/:environment/:version/charges/"  \
-X POST
-H "authorization:Px2e5oHhQZ88vVhc0DO%2FsShHj8MDDg%3DEXAMPLESIGNATURE"
-H "x-amz-pay-date:20201012T235046Z"
-H "x-amz-pay-idempotency-key:AVLo5tI10BHgEk2jEXAMPLEKEY"
-d @request_body
```

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

```
{
    "chargePermissionId": "P21-1111111-1111111",
    "chargeAmount": {
        "amount": "14.00",
        "currencyCode": "USD"
    },
    "chargeInitiator":"CITU",
    "channel":"Web",
    "captureNow": true, // default is false
    "softDescriptor": "Descriptor",
    "canHandlePendingAuthorization": false //default is false
}
```


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

<table width="100%" border="1">
    <tbody>
        <tr id='OLS9CAejjWl'>
            <td id='s:OLS9CAejjWl;OLS9CAhZC2S' style='vertical-align: top; font-weight: bold; width: 30%;' class='bold'>名前
                <br /></td>
            <td id='s:OLS9CAejjWl;OLS9CAkcqjC' style='vertical-align: top; font-weight: bold; width: 20%;' class='bold'>ロケーション
                <br /></td>
            <td id='s:OLS9CAejjWl;OLS9CAs0lqL' style='vertical-align: top; font-weight: bold; width: 50%;' class='bold'>説明
                <br /></td>
        </tr>
        <tr id='OLS9CA77dB4'>
            <td id='s:OLS9CA77dB4;OLS9CAOL3El' style='vertical-align: top;'>x-amz-pay-idempotency-key<br><b>(必須)</b><br><br>Type: string
                <br /></td>
            <td id='s:OLS9CA77dB4;OLS9CAJIYUN' style='vertical-align: top;'>Header
                <br /></td>
            <td id='s:OLS9CA77dB4;OLS9CAr63HH' style='vertical-align: top;'>リクエストを安全にリトライするための<a target="_blank" rel="noopener noreferrer" href="../amazon-pay-api-v2/idempotency.md">冪等キー</a>
                <br /></td>
        </tr>
        <tr id='OLS9CA74jkX'>
            <td id='s:OLS9CA74jkX;OLS9CAOL3El' style='vertical-align: top;'>chargePermissionId<br><b>(必須)</b><br><br>Type: string
                <br /></td>
            <td id='s:OLS9CA74jkX;OLS9CAJIYUN' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:OLS9CA74jkX;OLS9CAr63HH' style='vertical-align: top;'>ChargePermission識別子
                <br /></td>
        </tr>
        <tr id='OLS9CAbQJii'>
            <td id='s:OLS9CAbQJii;OLS9CAOL3El' style='vertical-align: top;'>chargeAmount<br><b>(必須)</b><br><br>Type: <a target="_blank" rel="noopener noreferrer" href="../amazon-pay-paymentmethodonfile/charge.md#type-price">price</a>
                <br /></td>
            <td id='s:OLS9CAbQJii;OLS9CAJIYUN' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:OLS9CAbQJii;OLS9CAr63HH' style='vertical-align: top;'>請求金額
                <br /></td>
        </tr>
        <tr id='OLS9CAoRCbH'>
            <td id='s:OLS9CAoRCbH;OLS9CAOL3El' style='vertical-align: top;'>captureNow<br><br>Type: boolean
                <br /></td>
            <td id='s:OLS9CAoRCbH;OLS9CAJIYUN' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:OLS9CAoRCbH;OLS9CAr63HH' style='vertical-align: top;'>オーソリが成功した直後に売上請求をする必要があるかどうかを示すブール値<br><br>デフォルト: false
                <br /></td>
        </tr>
        <tr id='OLS9CATXn9U'>
            <td id='s:OLS9CATXn9U;OLS9CAOL3El' style='vertical-align: top;'>softDescriptor<br><br>Type: string
                <br /></td>
            <td id='s:OLS9CATXn9U;OLS9CAJIYUN' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:OLS9CATXn9U;OLS9CAr63HH' style='vertical-align: top;'><code>CaptureNow</code>をtrueに設定している場合、購入者のお支払い方法ステートメントに表示される説明。<code>CaptureNow</code>がfalseに設定されている場合は、この値を設定しないでください。この項目には、購入者や取引に関する機密データを保存しないでください(例えば、政府発行の身分証明書、銀行口座番号、クレジットカード番号などが含まれますが、これらに限定されません)<br><br><strong>※日本では利用できません。固定値が表示されます。</strong><br><br>このsoft descriptorは以下の形式で連携されます。: "AMZ* &lt;soft descriptor specified here&gt;"<br><br>Default: "AMZ*&lt;SELLER_NAME&gt; pay.amazon.com"<br>最大長: 16 文字
                <br /></td>
        </tr>
        <tr id='OLS9CAUIIUV'>
            <td id='s:OLS9CAUIIUV;OLS9CAOL3El' style='vertical-align: top;'>canHandlePendingAuthorization<br><br>Type: boolean
                <br /></td>
            <td id='s:OLS9CAUIIUV;OLS9CAJIYUN' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:OLS9CAUIIUV;OLS9CAr63HH' style='vertical-align: top;'>事業者が保留のレスポンスを処理できるかどうかを示すブール値<br><br>falseに設定すると、US,EU,UK地域では最大15秒以内、JP地域では最大30秒以内にレスポンスが返されます。trueに設定すると、Amazon Payはオーソリを非同期で処理し、24時間以内にレスポンスを返します。詳細については、<a href="../amazon-pay-checkout/asynchronous-processing.md" target="_blank" rel="noopener noreferrer">非同期処理</a>を参照してください
                <br /></td>
        </tr>
        <tr id=''>
            <td id='' style='vertical-align: top;'>merchantMetadata<br><br>Type: <a href="../amazon-pay-paymentmethodonfile/charge.md#type-merchantmetadata" target="_blank" rel="noopener noreferrer">merchantMetadata</a>
                <br /></td>
            <td id='' style='vertical-align: top;'>Body
                <br /></td>
            <td id='' style='vertical-align: top;'>事業者が設定する注文の詳細情報
                <br /></td>
        </tr>
         <tr id=''>
            <td id='' style='vertical-align: top;'>providerMetadata<br><br>Type: <a href="../amazon-pay-paymentmethodonfile/charge.md#type-providermetadata" target="_blank" rel="noopener noreferrer">providerMetadata</a>
                <br /></td>
            <td id='' style='vertical-align: top;'>Body
                <br /></td>
            <td id='' style='vertical-align: top;'>決済サービスプロバイダー（PSP）が設定する注文の詳細情報<br><br>PSPのみがこれらのフィールドを使用します
                <br /></td>
        </tr>
        <tr id=''>
            <td id='' style='vertical-align: top;'>chargeInitiator<br /><br />Type: string
                <br /></td>
            <td id='' style='vertical-align: top;'>Body
                <br /></td>
            <td id='' style='vertical-align: top;'>請求の指示者を示します。
                <br><br>サポートされている値: 'CITU', 'MITU', 'CITR', 'MITR'
                <br><br><b>CITU</b>: これは、<b>customer-initiated unscheduled(購入者の指示によるタイミングの決まっていない請求)</b>の場合に利用します。購入者の操作に寄って事業者が課金をする場合にはこの値を設定して下さい。Amazon Payは購入者の意図によりこの取引が行われたと判断します。
                <br><br><b>MITU</b>: これは、<b>merchant-initiated unscheduled(事業者の指示によるタイミングの決まっていない請求)</b>の場合に利用します。購入者の具体的な決済操作がなく、事業者が決済方法の確認を行わない場合にこの値を設定して下さい。 Amazon Payは、全ての支払い取引において、事業者と購入者の間で購入者が事業者からの不定期な請求に同意したものとみなします。                
                <br><br>このケースでは様々なユースケースが考えられます。例えば、
                <ul>
                <li>タイミングのずれた請求取引</li>
                <li>オーソリの追加取引</li>
                <li>購入者が店舗やサイトに現れない取引</li>
                <li>請求タイミングの定まっていない認証情報が設定済みの取引</li>
                <li>その他の顧客認証情報を登録済みの取引</li>
                </ul>
                <b>CITR</b>: これは、<b>customer-initiated transaction representing(定期的な決済に対する購入者の指示による初回の請求)</b>の場合に利用します。購入者が既にお支払い方法の設定をする際に、合わせて継続的な支払い（サブスクリプション）の請求を行う場合には、この値を設定して下さい。
                <br><br><b>MITR</b>: これは、<b>merchant-initiated transaction(定期的な決済に対する２回目以降の事業者の指示による請求)</b>の場合に利用します。 定期的な請求を行うサービスの場合に２回目以降の請求を行う場には、この値を設定して下さい。
                <br /></td>
        </tr>
        <tr id=''>
            <td id='' style='vertical-align: top;'>channel<br /><br />Type: string
                <br /></td>
            <td id='' style='vertical-align: top;'>Body
                <br /></td>
            <td id='' style='vertical-align: top;'>請求時のチャネルを指します。
                <br><br>サポートされている値: 'Web', 'App', 'Firetv', 'Offline'
                <br><br>下記のケースに応じて値を設定して下さい。
                <ol>
                <li>Web: デスクトップかモバイルブラウザ</li>
                <li>App: モバイルアプリ</li>
                <li>Firetv: FireTV</li>
                <li>Offline: 購入者が明示的に指示を行っていないケース</li>
                </ol>
                <br /></td>
        </tr>
        <tr id='OLS9CA74jkX'>
            <td id='s:OLS9CA74jkX;OLS9CAOL3El' style='vertical-align: top;'>checkoutResultReturnUrl<br><br>Type: string
                <br /></td>
            <td id='s:OLS9CA74jkX;OLS9CAJIYUN' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:OLS9CA74jkX;OLS9CAr63HH' style='vertical-align: top;'><b>(EU/UKの事業者のみ)</b>事業者から提供された決済結果のURL。トランザクションの完了後、Amazon PayはこのURLにリダイレクトします。<br><br>このパラメーターは、購入者が多要素認証を求められた場合に請求処理をハンドリングするために必須となります。
                <br /></td>
        </tr>
    </tbody>
</table>

#### レスポンス

```
{
     "chargeId": "P21-1111111-1111111-C111111",
     "chargePermissionId": "P21-1111111-1111111",
     "chargeInitiator":"CITU",
     "channel":"Web",
     "chargeAmount": {
         "amount": "14.00",
         "currencyCode": "USD"
     },
     "captureAmount": {
         "amount": "14.00",
         "currencyCode": "USD"
     },
     "refundedAmount": {
         "amount": "0.00",
         "currencyCode": "USD"
     },
     "convertedAmount": "14.00",
     "conversionRate": "1.00",
     "softDescriptor": "Descriptor",
     "merchantMetadata": null,
     "providerMetadata": {
         "providerReferenceId": null
     },
     "statusDetails":{
         "state": "Captured",
         "reasonCode": null,
         "reasonDescription": null,
         "lastUpdatedTimestamp": "20190714T155300Z"
     },
     "creationTimestamp": "20190714T155300Z",
     "expirationTimestamp": "20190715T155300Z",
     "releaseEnvironment": "Sandbox"
}
```

***

#### 購入者が多要素認証を求められた場合のハンドリング <b>(EU/UKの事業者のみ)</b>
`chargeInitiator`が"CITU"か"CITR"で請求を実施する場合, 購入者は設定しているお支払い方法への認証を求められるケースがあります。この場合、<a href="../amazon-pay-paymentmethodonfile/charge.md#create-charge" target="_blank" rel="noopener noreferrer">Create Charge</a> は、202 ステータスコードをレスポンスで返します。この際、chargeの`state`: "ActionRequired"、`reasonCode`: "BuyerActionRequired"となります。<br/>請求を完了させるには、  

1. chargeレスポンスに返却された`amazonPayRedirectUrl`に購入者をリダイレクトします。Amazon Payは購入者に多要素認証を実施するためのページを表示します。多要素認証が完了したら、checkoutResultReturnUrlにリダイレクトを行います。
2. 購入者が事業者のサイトに戻ってきたことの確認として、<a href="../amazon-pay-paymentmethodonfile/checkout-session.md#complete-checkout-session" target="_blank" rel="noopener noreferrer">Complete Checkout Session</a>を実行します。

#### リクエスト

```
curl "https://pay-api.amazon.com/:version/charges/" \
-X POST
-H "authorization:Px2e5oHhQZ88vVhc0DO%2FsShHj8MDDg%3DEXAMPLESIGNATURE"
-H "x-amz-pay-date:20201012T235046Z"
-H "x-amz-pay-idempotency-key:AVLo5tI10BHgEk2jEXAMPLEKEY"
-d @request_body
```

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

```
{
    "chargePermissionId": "P21-1111111-1111111",
    "chargeAmount": {
        "amount": "14.00",
        "currencyCode": "USD"
    },
    "chargeInitiator":"CITU",
    "channel":"Web",
    "captureNow": true, // default is false
    "softDescriptor": "Descriptor",
    "canHandlePendingAuthorization": false //default is false
    "webCheckoutDetails": {
        "checkoutResultReturnUrl": "URL"
    }
}
```


#### レスポンス

```
{
     "chargeId": "P21-1111111-1111111-C111111",
     "chargePermissionId": "P21-1111111-1111111",
     "chargeInitiator":"CITU",
     "channel":"Web",
     "chargeAmount": {
         "amount": "14.00",
         "currencyCode": "USD"
     },
     "captureAmount": {
         "amount": "14.00",
         "currencyCode": "USD"
     },
     "refundedAmount": {
         "amount": "0.00",
         "currencyCode": "USD"
     },
     "convertedAmount": "14.00",
     "conversionRate": "1.00",
     "softDescriptor": "Descriptor",
     "merchantMetadata": null,
     "providerMetadata": {
         "providerReferenceId": null
     },
     "statusDetails":{
         "state": "ActionRequired",
         "reasonCode": "BuyerActionRequired",
         "reasonDescription": "Charge requires buyer action to proceed.",
         "lastUpdatedTimestamp": "20190714T155300Z"
     },
     "webCheckoutDetails": {
        "checkoutResultReturnUrl": "URL",
        "amazonPayRedirectUrl": "URL" // post-order URL to complete MFA
     }
     "creationTimestamp": "20190714T155300Z",
     "expirationTimestamp": "20190715T155300Z",
     "releaseEnvironment": "Sandbox"
}
```

購入者が多要素認証を完了すると、Amazon PayはcheckoutResultReturnUrlにリダイレクトを行います。checkout session ID はクエリパラメータに含まれて事業者に連携されます。 
購入者が認証を完了して事業者のサイトに戻ってきたことの確認として、<a href="../amazon-pay-paymentmethodonfile/checkout-session.md#complete-checkout-session" target="_blank" rel="noopener noreferrer">Complete Checkout Session</a>を実行します。

Notes: Amazon Payは、 Complete Checkout Sessionによって事業者による確認がされるまで処理を確定しません。24時間以内に確認がされない場合、Checkout Sessionはキャンセルされ、オーソリもキャンセルされます。

**成功のレスポンス:**

トランザクションが正常に処理された場合、 <a href="../amazon-pay-paymentmethodonfile/checkout-session.md#complete-checkout-session" target="_blank" rel="noopener noreferrer">Complete Checkout Session</a> は成功レスポンスを返します。

**エラーレスポンス:**

<a href="../amazon-pay-paymentmethodonfile/checkout-session.md#complete-checkout-session" target="_blank" rel="noopener noreferrer">Complete Checkout Session</a> は、失敗したトランザクションに対しては、エラーレスポンスを返します。購入者は多要素認証を途中でキャンセルしたか、正常に完了できませんでした。この場合は、次の手順を実施してください。 

1. 購入者を決済の開始時点にリダイレクトします
2. 「Amazon Payでのお支払いに失敗しました。別のお支払い方法をお試しください。」などのメッセージを表示します。



### 2. キャンセルの管理

PaymentMethodOnFile利用者が保存をキャンセル/解除した場合は、<a href="../amazon-pay-paymentmethodonfile/charge-permission.md#close-charge-permission" target="_blank" rel="noopener noreferrer">Close Charge Permission</a>を使用してAmazon Payに連携します。 ChargePermissionを閉じた後、お支払い方法設定の保存を新たに行わない限り、PaymentMethodOnFile利用者に請求することはできなくなります。

PaymentMethodOnFile利用者は、<a href="https://pay.amazon.com" target="_blank" rel="noopener noreferrer">https://pay.amazon.com</a>にサインインして、PMOF ChargePermissionを閉じることもできます。ChargePermissionが閉じられた場合に通知を受信するように <a href="../amazon-pay-paymentmethodonfile/set-up-instant-payment-notifications.md" target="_blank" rel="noopener noreferrer">IPNを設定</a>します。請求不可の状況を最小限に抑えるために、次の請求サイクルの前に、新しい支払い方法の設定について利用者に積極的に連絡することをお勧めします。

### 3. 支払い方法の変更

#### 購入者向けAmazon Payマイページでの支払い方法の変更
購入者は、Amazon Payのサイト <a href="https://pay.amazon.co.jp/" target="_blank" rel="noopener noreferrer">https://pay.amazon.co.jp/</a> から、選択した支払い方法を更新できます。その後の請求は、更新された支払い方法を使用して処理されます。更新以前の請求に関連する支払い方法は変更されません。また、購入者に直接PMOF ChargePermissionに紐づく次のリンクを提供して、支払い方法を簡単に更新してもらう事もできます。URL：https://pay.amazon.com/jp/jr/your-account/ba/{ChargePermissionId}。　※{ChargePermissionId}の部分を購入者のPMOF ChargePermissionIdに置き換えます。

<!-- #### Amazon Pay Hosted Page上でのお届け先と支払い方法の変更

事業者は、Amazon Pay Hosted Page上でのお届け先と支払い方法の変更を行わせる機能を実装することもできます。実装方法の詳細については、<a href="../amazon-pay-paymentmethodonfile/steps-to-integrate-with-amazon-pay-hosted-update-page.md" target="_blank" rel="noopener noreferrer">Amazon Pay Hosted Pageでのお届け先/支払い方法変更のインテグレーション手順</a>を参照下さい。 -->


### 4. Payment Method On Fileの有効期限

chargePermissionType： `paymentMethodOnFile` となっているChargePermissionの場合、有効期限はありません。ChargePermissionがクローズされるまで利用することが可能です。(`expirationTimestamp`はnullとなります)