---
title: 支払い情報を設定する
url: ja/amazon-pay-recurring-checkout/ja-set-payment-info.html
---

**[ステップ4/9]** このステップでは、支払い情報を設定し、購入者への請求方法を指定します。このステップの最後に、トランザクション処理のために購入者を一意の `amazonRedirectUrl` にリダイレクトできるようになります。

<!-- <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/checkout-session.md#update-checkout-session" target="_blank" rel="noopener noreferrer">Update Checkout Session</a> を呼び出して、支払い情報（注文金額）とトランザクションメタデータを設定します。`checkoutResultReturnUrl`パラメータを使用して、購入者がホストするページで決済が完了した後に購入者がリダイレクトされる先となるURLを指定します。

<div markdown="span" class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Amazon Payボタンをレンダリングしたドメインと異なる場合は、使用する予定のcheckoutReviewReturnUrlドメインをセラーセントラルに追加する必要があります。詳細については、<a href='../amazon-pay-recurring-checkout/get-set-up-for-integration.html#2-セラーセントラルにドメインを追加します' target='_blank' rel='noopener noreferrer'>セラーセントラルへのドメイン追加</a>をご覧ください。</div>

`chargeAmount` を、決済で設定した `paymentIntent` に沿って設定します。決済の完了後に追加の支払いを行うために注文を分割する必要がある場合は、オプションの `totalOrderAmount` パラメータを使用して、そこに注文の全額を設定します。

#### リクエスト


<div style="display:none" class="environmentSpecificKeys">
<code style="color:black">
curl "https://pay-api.amazon.com/:version/checkoutSessions/:checkoutSessionId" \<br />
-X PATCH<br />
-H "authorization:Px2e5oHhQZ88vVhc0DO%2FsShHj8MDDg%3DEXAMPLESIGNATURE"<br />
-H "x-amz-pay-date:20201012T235046Z"<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/checkoutSessions/:checkoutSessionId" \<br />
-X PATCH<br />
-H "authorization:Px2e5oHhQZ88vVhc0DO%2FsShHj8MDDg%3DEXAMPLESIGNATURE"<br />
-H "x-amz-pay-date:20201012T235046Z"<br />
-d @request_body<br />
</code>
</div>

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

```
{
    "webCheckoutDetails": {
        "checkoutResultReturnUrl": "https://a.com/merchant-confirm-page"
    },
    "paymentDetails": {
        "paymentIntent": "AuthorizeWithCapture",
        "canHandlePendingAuthorization":false,
        "softDescriptor": "Descriptor",
        "chargeAmount": {
            "amount": "1",
            "currencyCode": "USD"
        }
     },
    "merchantMetadata": {
        "merchantReferenceId": "Merchant reference ID",
        "merchantStoreName": "Merchant store name",
        "noteToBuyer": "Note to buyer",
        "customInformation": "Custom information"
    }
}
```



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

<table width="100%" border="1">
    <tbody>
        <tr id='ERL9CAipzsl'>
            <td id='s:ERL9CAipzsl;ERL9CAFccoh' style='vertical-align: top; font-weight: bold; width: 30%;' class='bold'>名前
                <br /></td>
            <td id='s:ERL9CAipzsl;ERL9CAjQdu4' style='vertical-align: top; font-weight: bold; width: 20%;' class='bold'>ロケーション
                <br /></td>
            <td id='s:ERL9CAipzsl;ERL9CAxmCJ7' style='vertical-align: top; font-weight: bold; width: 50%;' class='bold'>説明
                <br /></td>
        </tr>
        <tr id='ERL9CA4LMaA'>
            <td id='s:ERL9CA4LMaA;ERL9CAFccoh' style='vertical-align: top;'>checkoutSessionId<br><b>(必須)</b><br><br>Type: string
                <br /></td>
            <td id='s:ERL9CA4LMaA;ERL9CAjQdu4' style='vertical-align: top;'>Path parameter
                <br /></td>
            <td id='s:ERL9CA4LMaA;ERL9CAxmCJ7' style='vertical-align: top;'>Checkout Session識別子
                <br /></td>
        </tr>
        <tr id='ERL9CAvm2Or'>
            <td id='s:ERL9CAvm2Or;ERL9CAFccoh' style='vertical-align: top;'>webCheckoutDetails<br><br>Type: <a href="../amazon-pay-api-v2/checkout-session.md#type-webcheckoutdetails" target="_blank" rel="noopener noreferrer">webCheckoutDetails</a>
                <br /></td>
            <td id='s:ERL9CAvm2Or;ERL9CAjQdu4' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:ERL9CAvm2Or;ERL9CAxmCJ7' style='vertical-align: top;'>事業者から提供された決済結果のURL。トランザクションの完了後、Amazon PayはこのURLにリダイレクトします<br><br>変更可否: 購入者が<code>amazonPayReturnUrl</code>にリダイレクトされるまで回数制限なし
                <br /></td>
        </tr>
        <tr id=''>
            <td id='' style='vertical-align: top;'>recurringMetadata<br /><br />Type: <a href="../amazon-pay-api-v2/checkout-session.md#type-recurringmetadata" target="_blank" rel="noopener noreferrer">recurringMetadata</a>
                <br /></td>
            <td id='' style='text-align: left;vertical-align: top;'>Body
                <br /></td>
            <td id='' style='vertical-align: top;'>recurringのChargePermissionの使用方法に関するメタデータ。 Amazon Payは、この情報をChargePermissionの有効期限を計算と、購入者とのコミュニケーションにのみ使用します<br /><br />
            各請求サイクルで購入者に請求するために<a href="../amazon-pay-api-v2/charge.md#create-charge" target="_blank" rel="noopener noreferrer">Create Charge</a>を呼び出すのは、依然として事業者の責任であることに注意してください。
                <br /></td>
        </tr>
        <tr id='ERL9CAgQ4T4'>
            <td id='s:ERL9CAgQ4T4;ERL9CAFccoh' style='vertical-align: top;'>paymentDetails<br><br>Type: <a href="../amazon-pay-api-v2/checkout-session.md#type-paymentdetails" target="_blank" rel="noopener noreferrer">paymentDetails</a>
                <br /></td>
            <td id='s:ERL9CAgQ4T4;ERL9CAjQdu4' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:ERL9CAgQ4T4;ERL9CAxmCJ7' style='vertical-align: top;'>購入者に請求する金額や方法など、販売者が指定した支払いの詳細<br><br>変更可否: 購入者が<code>amazonPayReturnUrl</code>にリダイレクトされるまで回数制限なし
                <br /></td>
        </tr>
        <tr id='ERL9CA6JHj6'>
            <td id='s:ERL9CA6JHj6;ERL9CAFccoh' style='vertical-align: top;'>merchantMetadata<br><br>Type: <a href="../amazon-pay-api-v2/checkout-session.md#type-merchantmetadata" target="_blank" rel="noopener noreferrer">merchantMetadata</a>
                <br /></td>
            <td id='s:ERL9CA6JHj6;ERL9CAjQdu4' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:ERL9CA6JHj6;ERL9CAxmCJ7' style='vertical-align: top;'>事業者から提供された外部の注文詳細<br><br>変更可否: 購入者が<code>amazonPayReturnUrl</code>にリダイレクトされるまで回数制限なし
                <br /></td>
        </tr>
        <tr id='ERL9CA7OsPD'>
            <td id='s:ERL9CA7OsPD;ERL9CAFccoh' style='vertical-align: top;'>platformId<br><br>Type: string
                <br /></td>
            <td id='s:ERL9CA7OsPD;ERL9CAjQdu4' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:ERL9CA7OsPD;ERL9CAxmCJ7' style='vertical-align: top;'>ソリューションプロバイダー（SP）の事業者識別子<br><br>SPのみがこのフィールドを使用します。<br><br>変更可否: 購入者が<code>amazonPayReturnUrl</code>にリダイレクトされるまで回数制限なし
                <br /></td>
        </tr>
        <tr id='ERL9CAuzzTA'>
            <td id='s:ERL9CAuzzTA;ERL9CAFccoh' style='vertical-align: top;'>providerMetadata<br><br>Type: <a href="../amazon-pay-api-v2/checkout-session.md#type-providermetadata" target="_blank" rel="noopener noreferrer">providerMetadata</a>
                <br /></td>
            <td id='s:ERL9CAuzzTA;ERL9CAjQdu4' style='vertical-align: top;'>Body
                <br /></td>
            <td id='s:ERL9CAuzzTA;ERL9CAxmCJ7' style='vertical-align: top;'>決済サービスプロバイダー（PSP）によって作成されたトランザクション識別子<br><br>PSPのみがこれらのフィールドを使用します。<br><br>変更可否: 購入者が<code>amazonPayReturnUrl</code>にリダイレクトされるまで回数制限なし
                <br /></td>
        </tr>
    </tbody>
</table>

#### レスポンス

```
{
    "checkoutSessionId": "ada3f397-7d4b-4a55-abac-786685c02d8b",
    "webCheckoutDetails": {
        "checkoutReviewReturnUrl": "https://a.com/merchant-review-page",
        "checkoutResultReturnUrl": "https://a.com/merchant-confirm-page",
        "checkoutCancelUrl": null,
        "amazonPayRedirectUrl": "https://pay.amazon.com/redirect/checkoutId-1"
    },
    "chargePermissionType": "Recurring",   
    "recurringMetadata": {
        "frequency": { 
            "unit": "Month", 
            "value": "1" 
        },
        "amount": { 
            "amount": "30",
            "currencyCode": "USD"
        }
    },
    "productType": "PayAndShip",
    "paymentDetails": {
        "paymentIntent": "AuthorizeWithCapture",
        "canHandlePendingAuthorization": false,
        "chargeAmount": {
            "amount": "1",
            "currencyCode": "USD"
        },
        "totalOrderAmount": null,
        "softDescriptor": "Descriptor",
        "presentmentCurrency": "USD",
        "allowOvercharge": null,
        "extendExpiration": null
    },
    "merchantMetadata": {
        "merchantReferenceId": "Merchant reference ID",
        "merchantStoreName": "Merchant store name",
        "noteToBuyer": "Note to buyer",
        "customInformation": "Custom information"
    },
    "supplementaryData": null, // Amazon Pay system data 
    "buyer": {
        "buyerId": "buyerId",
        "name": "name-1",
        "email": "name@amazon.com",
        "phoneNumber": "800-000-0000",
        "primeMembershipTypes": null
    },
    "billingAddress":{
        "name": "Work",
        "addressLine1": "440 Terry Ave",
        "addressLine2": "",
        "addressLine3": "",
        "city": "Seattle",
        "county": "King",    
        "district": "Seattle",
        "stateOrRegion": "WA",
        "postalCode": "98121",
        "countryCode": "US",
        "phoneNumber": "800-000-0000"
    },
    "paymentPreferences": [
        {
            "paymentDescriptor": "Visa ****1111 (Amazon Pay)"
        }
    ],
    "statusDetails": {
        "state": "Open",
        "reasonCode": null,
        "reasonDescription": null,
        "lastUpdatedTimestamp": "20191015T195703Z"
    },
    "shippingAddress": {  // Null for PayOnly product type
        "name": "Susie Smith",
        "addressLine1": "10 Ditka Ave",
        "addressLine2": "Suite 2500",
        "addressLine3": null,
        "city": "Chicago",
        "county": null,
        "district": null,
        "stateOrRegion": "IL",
        "postalCode": "60602",
        "countryCode": "US",
        "phoneNumber": "800-000-0000"
    },
    "platformId": null,
    "chargePermissionId": null,
    "chargeId": null,
    "constraints": [],
    "creationTimestamp": "20191015T195655Z",
    "expirationTimestamp": "20191016T195655Z",
    "storeId": "amzn1.application-oa2-client.8b5e45312b5248b69eeaStoreId",
    "deliverySpecifications": {
        "specialRestrictions": ["RestrictPOBoxes"],
        "addressRestrictions": {
            "type": "Allowed",
            "restrictions": {
                "US": {
                    "statesOrRegions": ["WA"],
                    "zipCodes": ["95050", "93405"]
                },
                "GB": {
                    "zipCodes": ["72046", "72047"]
                },
                "IN": {
                    "statesOrRegions": ["AP"]
                },
                "JP": {}
            }
        }
    },
    "providerMetadata": {
        "providerReferenceId": null
    },
    "releaseEnvironment": "Sandbox"
}
```

***

### 2. AmazonPayRedirectUrlにリダイレクト実施

すべての必須パラメータが提供されるまで、<a href="../amazon-pay-api-v2/checkout-session.md#update-checkout-session" target="_blank" rel="noopener noreferrer">Update Checkout Session</a> レスポンスには、<a href="../amazon-pay-api-v2/checkout-session.md#type-constraint" target="_blank" rel="noopener noreferrer">Constraint object</a> が含まれます。必須パラメータは次のとおりです。

* `checkoutResultReturnUrl`
* `chargeAmount`
* `paymentIntent`
* `recurringMetadata.frequency`

constraintsがなくなると、レスポンスは一意の`amazonPayRedirectUrl`を返却します。決済を完了するには、購入者をそのURLにリダイレクトします。