決済を確認・完了する
[ステップ3/7] Amazon Payがトランザクションまたはお支払い方法設定を処理した後、購入者はcheckoutResultReturnUrlにリダイレクトされます。 Amazon PayのCheckout Session IDがクエリパラメータとして含まれます。
このステップでは、CheckoutSession IDを使用して、購入者がサイトに正常に戻ったことを確認し、paymentIntent
を確定します。このステップの最後に、購入者に決済結果を提示できるようになります。
1. 決済の完了
Complete Checkout Sessionを使用して、購入者がサイトに正常に戻ったことを確認します。検証のため、リクエストのchargeAmount
は、 CheckoutSessionオブジェクトのpaymentDetails.chargeAmount
と一致する必要があります。 CheckoutSessionオブジェクトにtotalOrderAmount
が提供されている場合は、 totalOrderAmountも指定する必要があります。
Note:
- PaymentMethodOnFileの
"setupOnly": true
で実装する場合、chargeAmount
は必須項目ではありません。 - Amazon Payは、Complete Checkout Sessionによって事業者からの処理完了の確認がされるまで
paymentIntent
を確定しません。24時間以内に確認がされないCheckout SessionAmazon Payによってキャンセルされます。
成功のレスポンス:
トランザクションまたはお支払い方法設定が正常に処理された場合、Complete Checkout Sessionは成功レスポンスを返します。
エラーレスポンス:
Complete Checkout Sessionは、失敗したトランザクションまたはお支払い方法設定に対しては、エラーレスポンスを返します。購入者は設定を途中でキャンセルしたか、有効なお支払い方法を選択し設定を完了できませんでした。この場合は、次の手順を実施してください。
- 購入者を設定の開始にリダイレクトします
2.「Amazon Payでのお支払い方法設定に失敗しました。別の決済方法での設定をお試しください。」などのメッセージを表示します
リクエスト
リクエストボディ
{ }
リクエストパラメータ
Name
|
Location
|
Description
|
checkoutSessionId (required) Type: string |
Path parameter
|
Checkout Session identifier
|
レスポンス
{
"checkoutSessionId": "bd504926-f659-4ad7-a1a9-9a747aaf5275",
"webCheckoutDetails": null,
"chargePermissionType": null,
"recurringMetadata": null,
"productType": null,
"paymentDetails": null,
"merchantMetadata": null,
"paymentMethodOnFileMetadata": null,
"supplementaryData":null, // Amazon Pay system data
"buyer": null,
"billingAddress": null,
"paymentPreferences": [
null
],
"statusDetails": {
"state": "Completed",
"reasonCode": null,
"reasonDescription": null,
"lastUpdatedTimestamp": "20191015T204327Z"
},
"shippingAddress": null,
"platformId":null,
"chargePermissionId": "S01-5105180-3221187",
"chargeId": "S01-5105180-3221187-C056351",
"constraints": [
null
],
"creationTimestamp": "20191015T204313Z",
"expirationTimestamp": null,
"storeId": null,
"deliverySpecifications": null,
"providerMetadata": null,
"releaseEnvironment": null
}