チェックアウト後に情報を更新する
Recurring情報が変更された場合は、 recurringMetadataを更新することもできます。
Charge Permission が Chargeable または NonChargeable 状態の場合は、merchantMetadataパラメータを複数回更新できます。
Charge Permission が Closed 状態の場合は、chargePermissionTypeの更新されるパラメータ値が null である場合にのみ、mermerMetadata パラメータを更新できます。 Charge Permission が Closed 状態の場合、購入者への連絡には更新された値が反映されないことに注意してください。
リクエスト
リクエストボディ
{
"merchantMetadata": {
"merchantReferenceId": "32-41-323141-32",
"merchantStoreName": "AmazonTestStoreFront",
"noteToBuyer": "Some Note to buyer",
"customInformation": ""
},
"recurringMetadata": {
"frequency": {
"unit": "Month",
"value": "1"
},
"amount": {
"amount": "14",
"currencyCode": "USD"
}
}
}
リクエストパラメータ
| 名前
|
ロケーション
|
説明
|
| chargePermissionId (必須) Type: string |
Path Parameter
|
Charge Permission識別子
|
| recurringMetadata Type: recurringMetadata |
Body
|
recurringCharge Permissionの使用方法に関するメタデータ。 Amazon Payはこの情報を、Charge Permissionの有効期限の計算と購入者通知のみに使用します。
請求サイクルごとに購入者に請求するためにCreate Chargeを実行するのは事業者責任であることに注意してください |
| merchantMetadata Type: merchantMetadata |
Body
|
販売者が提供する注文の詳細 変更可否: チェックアウト後に情報を更新するをご参照下さい。 |
レスポンス
{
"chargePermissionId": "chargePermission-1",
"chargePermissionReferenceId": null,
"chargePermissionType": "Recurring",
"recurringMetadata": {
"frequency": {
"unit": "Month",
"value": "1"
},
"amount": {
"amount": "14",
"currencyCode": "USD"
}
},
"buyer": {
"buyerId": "buyerId",
"name": "name-1",
"email": "name@amazon.com",
"phoneNumber": "800-000-0000",
"primeMembershipTypes": null
},
"releaseEnvironment": "Live",
"shippingAddress":{ // Null for PayOnly product type
"name": "Work",
"addressLine1": "440 Terry Ave",
"addressLine2": "",
"addressLine3": "",
"city": "Seattle",
"county": "King",
"district": "Seattle",
"stateOrRegion": "WA",
"postalCode": "98121",
"countryCode": "US",
"phoneNumber": "800-000-0000"
},
"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": null
}],
"statusDetails": {
"state": "Chargeable",
"reasons": null,
"lastUpdatedTimestamp": "20190714T155300Z"
},
"creationTimestamp": "20190714T155300Z",
"expirationTimestamp": "20190715T155300Z",
"merchantMetadata": {
"merchantReferenceId": "123-77-876",
"merchantStoreName": "AmazonTestStoreFront",
"noteToBuyer": "merchantNoteForBuyer",
"customInformation": "This is custom information"
},
"platformId": "SPId",
"limits": {
"amountLimit": {
"amount": "14.00",
"currencyCode": "USD"
},
"amountBalance": {
"amount": "14.00",
"currencyCode": "USD"
}
},
"presentmentCurrency": "USD"
}