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.


Copyright © 2009-2018 Amazon.com, Inc. or its affiliates. Amazon and Amazon.com are registered trademarks of Amazon.com, Inc. or its affiliates. All other trademarks are the property of their respective owners.