amazon-payamazonsellercentral

How to adjust the frequency and duration of billing agreements for Amazon Pay


I am integrating amazon pay for our non-profit that offers one-time, monthly, and yearly donation plants.

I looked around and was not able to find how we could set the duration ( how long should the billing agreement continue) or the frequency ( how often should the buyer be charged ). I am not even sure if this feature is available or if billing agreements are only monthly subscriptions.

When I use the sandbox and hit the amazon api with GetBillingAgreementDetails, I see the TimePeriodEndDate which is only one month after TimeStartEndDate. I assume this is the time frame that the billingAgreement runs for, but I could not find a way to alter that period in the documentation.

Please help.

Thank you


Solution

  • There is no duration or frequency that you can set for Billing Agreements. Instead, it is up to you to decide when and how much you want to charge a buyer for when necessary (requires the Billing Agreement to be valid of course, this is what the GetBillingAgreementDetails API call is being used for example).

    For charging the buyer, you need to call AuthorizeOnBillingAgreement as described in this step of the integration guide.

    The time periods that you are referring to are part of the BillingAgreementLimits object and tell you the maximum amount and the remaining balance that you can charge the buyer for in the time period that is defined by TimeStartEndDate and TimePeriodEndDate. The period is a read-only field and set by the Amazon Pay API.