API Version 2 移行ガイド

API version2では、重大な変更が導入されています。 APIエンドポイントのversionパラメータを更新し、このガイドに従ってversion1からversion2に移行します。

API関連の更新

一部のパラメーターの名前が変更されたか、再構築されました。以下の変更を確認し、影響を受けるパラメーターの1つを具体的に参照している場合は、コードを更新してください。

Checkout Session

パラメータ-
変更の説明
billingAddress
billingAddressがpaymentPreferences配列からトップレベルノードに移動しました
webCheckoutDetail
webCheckoutDetailの名前がwebCheckoutDetailsに変更されました
paymentDetail
PaymentDetailの名前がpaymentDetailsに変更されました
statusDetail
statusDetailの名前がstatusDetailsに変更されました

Charge Permission

パラメータ-
変更の説明
billingAddress
billingAddressがpaymentPreferences配列からトップレベルノードに移動しました
chargeAmountLimit
amountLimitとaccountBalanceをカプセル化する制限に置き換えられました
statusDetail
statusDetailの名前がstatusDetailsに変更されました

Charge

パラメータ-
変更の説明
statusDetail
statusDetailの名前がstatusDetailsに変更されました

Refund

パラメータ-
変更の説明
statusDetail
statusDetailの名前がstatusDetailsに変更されました

Complete Checkout Session API

Version 2のCheckout Sessionオブジェクトは、paymentIntentを確定するために、購入者がamazonResultReturnUrlにリダイレクトされたときに確認されなければなりません。24時間以内に確認されないCheckout Sessionはキャンセルされます。

購入者がamazonResultReturnUrlにリダイレクトされたときにCheckout Sessionの状態を検証するために実行していたGet Checkout Sessionを、Complete Checkout Sessionリクエストに変更してください。トランザクション処理が成功した場合、Complete Checkout sessionは成功レスポンスを返します。それ以外の場合は、エラーレスポンスを返します。

支払いを承認および取得するために実装した他のロジックは変更する必要はありません。