Billing Agreement状態と理由コード | Amazon Pay Japan

Billing Agreement状態と理由コード

次の図はBilling Agreementオブジェクトの状態遷移です。

次の表はそれぞれのオーソリ状態の詳細、許可されている処理、その状態になった理由の説明です。

状態 説明 許可されている処理 理由コード
Draft Billing AgreementはConfirmBillingAgreement処理を呼び出し承認する前の Draft状態です。 CreateOrderReferenceForId

GetBillingAgreementDetails

SetBillingAgreementDetails

ConfirmBillingAgreement
Open Draft状態のBilling Agreementオブジェクトは、ConfirmBillingAgreement処理を呼び出し承認された後に Open状態に遷移します。

購入者がAmazonのアドレス帳またはお支払い方法 ウィジェットを利用して、Billing Agreementオブジェクトの住所と支払方法を変更した場合は、Billing Agreementオブジェクトも承認しなければなりません。

オーソリはBilling AgreementがOpen状態のみリクエストできます。
CreateOrderReferenceForId

GetBillingAgreementDetails

ConfirmBillingAgreement

ValidateBillingAgreement

AuthorizeOnBillingAgreement

CloseBillingAgreement
Suspended Billing Agreementオブジェクトは、Amazonがオーソリ処理にて支払方法に問題があった場合は、Suspendedに遷移します。Billing Agreementが Suspended状態の場合は、新しいOrder Referenceの生成、または、新しいオーソリのリクエストができません。しかし、すでに存在するオーソリの売上請求と売上請求の返金は可能です。

Billing AgreementオブジェクトがInvalidPaymentMethodの理由コードによって Suspendedに遷移した場合は、購入者にその他の支払方法を要求してください。
GetBillingAgreementDetails

ConfirmBillingAgreement

CloseBillingAgreement
InvalidPaymentMethod
支払方法に問題があります。
Canceled Billing Agreementは、3時間以内にてConfirmBillingAgreement処理を利用して承認しなかった場合はAmazonによってキャンセルになります。または、Amazonのその他の理由でキャンセルになりました。

多くのOpenのオーソリとOrder Referenceはキャンセルされ、新しい支払処理は将来的に許可されません。
GetBillingAgreementDetails Stale
許可された3時間以内にてConfirmBillingAgreement処理を呼び出さなかったためにBilling Agreementは承認されませんでした。

AmazonCanceled
AmazonはBilling Agreementをキャンセルにしました。
Closed Billing AgreementはCloseBillingAgreement処理の呼び出しでClosedになるか、AmazonによってClosedになりました。

Billing AgreementがClosed状態では、新しいOrder Reference、新しいオーソリのリクエストはできません。存在するオーソリの売上請求は許可されています。

売上請求の返金は許可されています。
GetBillingAgreementDetails AmazonClosed
Amazonは内部確認の失敗によりBilling AgreementをClosedにしました。

SellerClosed
販売事業者がCloseBillingAgreement処理を呼び出してBilling Agreementを明示的にClosedにしました。Closedにした理由をClosedBillingAgreement処理の ClosureReasonリクエストパラメータに指定できます。

BuyerClosed
購入者がAmazon PayのWebサイトからBilling AgreementをClosedにしました。