Billing agreement constraints

A Billing Agreement object is only eligible for creating an order reference using the CreateOrderReferenceForId operation or requesting a payment authorization using the AuthorizeOnBillingAgreement operation after you confirm the billing agreement by calling the ConfirmBillingAgreement operation. The ConfirmBillingAgreement operation call succeeds only if there are no constraints on the Billing Agreement object. Constraints indicate that important information is either missing or invalid.

You can take corrective actions to fix the billing agreement and remove the constraints before calling the ConfirmBillingAgreement operation. The following table lists the constraints and corrective actions you must take to remove the constraint:

ConstraintId Description Corrective action
BuyerConsentNotSet The buyer has not given consent for this billing agreement. Show the Amazon Consent widget to the buyer to obtain their consent.
BuyerEqualsSeller The buyer cannot be the seller for this transaction. There is no corrective action. You cannot shop on your own website.
PaymentPlanNotSet The buyer has not set a payment method for the given billing agreement. Show the Amazon Wallet widget to the buyer to collect payment information.
ShippingAddressNotSet The buyer has not chosen a shipping address from the Amazon AddressBook widget. Show the Amazon AddressBook widget to the buyer to collect shipping information.

Certain constraints might be added to the billing agreement after it has been confirmed. In this case, the billing agreement is moved to the Suspended state. You must take the corrective action described below and confirm the billing agreement again using the ConfirmBillingAgreement operation before calling the CreateOrderReferenceForId or AuthorizeOnBillingAgreement operations.

ConstraintId Description Corrective action
BillingAddressDeleted The buyer has deleted the billing address of the selected payment method from his or her Amazon account. Ask the buyer to update the billing address or choose a different payment method from the Amazon Pay website under Merchant Agreements.
InvalidPaymentPlan The selected payment method is no longer valid and cannot be used. Ask the buyer to choose a different payment method from the Amazon Pay website under Merchant Agreements.
PaymentMethodDeleted The buyer has deleted the selected payment method from his or her Amazon account. Ask the buyer to choose a different payment method from the Amazon Pay website under Merchant Agreements.
PaymentMethodExpired The selected payment method has expired. Ask the buyer to update the expiration date or choose a different payment method from the Amazon Pay website under Merchant Agreements.
PaymentMethodNotAllowed The payment method selected by the buyer is not allowed for this billing agreement. Ask the buyer to choose a different payment method from the Amazon Pay website under Merchant Agreements.