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は成功レスポンスを返します。それ以外の場合は、エラーレスポンスを返します。
支払いを承認および取得するために実装した他のロジックは変更する必要はありません。