決済を確認・完了する

[ステップ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:

  1. PaymentMethodOnFileの"setupOnly": trueで実装する場合、chargeAmount は必須項目ではありません。
  2. Amazon Payは、Complete Checkout Sessionによって事業者からの処理完了の確認がされるまでpaymentIntentを確定しません。24時間以内に確認がされないCheckout SessionAmazon Payによってキャンセルされます。

成功のレスポンス:

トランザクションまたはお支払い方法設定が正常に処理された場合、Complete Checkout Sessionは成功レスポンスを返します。

エラーレスポンス:

Complete Checkout Sessionは、失敗したトランザクションまたはお支払い方法設定に対しては、エラーレスポンスを返します。購入者は設定を途中でキャンセルしたか、有効なお支払い方法を選択し設定を完了できませんでした。この場合は、次の手順を実施してください。

  1. 購入者を設定の開始にリダイレクトします
    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
}