Getting Started

Product Catalog



Invoices, Credit Notes and Quotes



Site Configuration

Data Privacy & Security

Data Operations

Reports and Analytics


Amazon Payments 

Checkout by Amazon is an additional payment method you can offer your customers with an Amazon Buyer Account. During checkout, your customers can choose between a card payment method or with Pay with Amazon. Once they choose Amazon as their payment method, they need to login to their Amazon account and authorize payments.

After the checkout is done using this payment method, we store the billing agreement in Chargebee and use it for all future payments. Customers can change their payment method through the customer portal or you can do this on their behalf.

Setup in Chargebee 

  1. Connect your Amazon Payments Account
    To do this, go to Settings > Configure Chargebee > Payment Gateways and click Add a Gateway. This will direct you to a list of Gateways supported in Chargebee. Choose Amazon Payments from the list.

  2. On the Amazon Payments configuration page, click Connect and follow the prompts to log in to your Amazon Seller Account.

  3. You can sign in using your existing Amazon account or create a new one. In case you are creating a new account, enter your business details.

  4. Enter your web settings.

  5. Business Display Name: Enter your business name

  6. Checkout Domain: Enter the Chargebee domain URL. The URL that is allowed to connect with your Amazon Buyer Account.

  7. Privacy Policy: Enter the link to your privacy policy page.

  8. Allow Amazon to transfer credentials to Chargebee.

  9. Once this is done, your Amazon account credentials will be stored in Chargebee.

  10. Include a Seller Note. Content entered here will be shown to your customers when they log in to their Amazon Buyer Account console.

Setup in Amazon 

You need to configure and setup your Amazon account to allow checkout through a 3rd party shopping cart. To do this, login to your Amazon Seller Central  and select Amazon Payments Advanced.

You will see 2 of them - Production View & Sandbox View. When you're initially testing Amazon Payments, we recommend using the Sandbox View along with your Chargebee TEST site.

  1. Configure your Integrator URL
    You will find this URL in Chargebee under Settings > Configure Chargebee > Payment Gateways > Amazon Payments

  2. Configure this under Settings > Integration Settings in Amazon.

  3. If you don't see Integration Settings in your Settings menu, ensure that you have selected Amazon Payments Advanced as indicated above.

  4. Configure Allowed Javascript Origins
    This is your Chargebee domains and you will find them under Settings > Configure Chargebee > Payment Gateways > Amazon Payments. Copy these URLs.

  5. Switch to Login with Amazon and select your Chargebee application on the left.

  6. Scroll down to Web Settings to make necessary edits.

  7. Paste the URLs you copied from Chargebee and save it.


Add your Chargebee TEST and LIVE site domains here. If you're using Chargebee's customer portal, add those domains as well.

Checkout Using Amazon 

If you've enabled Amazon payments in your Chargebee Payment Gateway Settings as explained above, customers will see it as an option during a hosted page checkout.

After they select Amazon and click on Pay with Amazon, they will be prompted to enter their Amazon Buyer Account credentials.

Once the customer's account is successfully authenticated, they can see their address and payment details. Here they can choose which address and card to use.

Customers also have the option of adding a new address or card to their Amazon account from here.

Customers then have to authorize using their account by checking the box and then clicking on Next.

Now they can verify their order summary and also update their address details if required. At the bottom of the page, they can see their Amazon payment information and they also have the option of changing their payment method, if needed.

Amazon Payments with Chargebee's API 

To accept payments via Amazon Payments using your custom checkout page, here's the process to be followed in a nutshell:

  1. Integrate your site with Amazon Payments (Login & Pay with Amazon). Learn more.
  2. Configure your Amazon Payments settings in Chargebee. Learn more.
  3. Push Billing Agreement id obtained from Amazon, to ChargebeeLearn more.

P.S. Chargebee's Hosted Pages can still come to your rescue if you'd want to skip integrating with Amazon directly and quickly start accepting payments via Amazon Payments.

Integrating with Amazon Payments 

Chargebee uses the billing agreement id of Amazon Payments to capture future payments.

Follow the steps mentioned in this document to integrate with Login and Pay with Amazon.

Chargebee takes over from Step 8 of the above process. Set up Amazon Payments in your website by following Steps 1-7.
After Step 7 (Set Billing Agreement Details and Confirm the Agreement )of the process, pass the Billing Agreement information along with the subscription details to Chargebee.

Pushing information to Chargebee - Billing Agreement id 

After customers authorize their payment via Amazon, a billing agreement is created. Chargebee requires this Billing Agreement id to charge customers for all future recurring payments.

Chargebee can collect future payments only when the Billing Agreement object is in open state. For the Billing Agreement id to move from draft to open state, the Billing Agreement has to be confirmed.This can be done by calling the ConfirmBillingAgreement  operation. So, before passing the billing agreement id to Chargebee, ensure the agreement is confirmed.

The Billing Agreement id can be passed to Chargebee with the payment_method[reference_id] parameter, using any of the following APIs:

Refer here for further information.

Chargebee then sends this billing agreement id to Amazon to validate it. After validation, the Billing Agreement id is stored at Chargebee's end and used to charge the customer for future payments.

  • If the Billing Agreement is closed, Amazon Payments will notify Chargebee of the same. Chargebee will mark the payment method as INVALID and the whole process must be repeated once again.
  • During future payments, if the Billing Agreement is closed , Amazon Payments will notify Chargebee of the same. Chargebee will mark the payment method as INVALID and try to charge the customers at 3 different intervals if dunning is enabled. In case the payment is not collected or dunning is disabled, the final action set in the Dunning settings will take place. Read more on Dunning.

While creating a subscription for an existing customer, the option to specify the payment method information is not available. This is because, the payment method information is linked to customers and not the subscriptions.

Important points to note before using Amazon Payments with Chargebee 

  1. Amazon Payments is currently supported for merchants in the United States only.
  2. This payment method is only supported on hosted pages when used with the Minimal, Elegant or Inspire theme. It does not work with Chargebee's Rhapsody theme.
  3. Only supports card based payments using your customers' Amazon buyer account. Bank or other payment methods are not accepted with Chargebee.
  4. The only supported currency for Amazon Payments is USD.
  5. iframe tags are not supported by Amazon. Therefore, if you are using Chargebee Checkout you will have to add the following in the Header Script.
Was this article helpful?