Amazon Pay Gateway

Knowledge Center > Billing and Payments > Payment Gateways > Supported Payment Gateways > Amazon Pay Gateway

Amazon Pay Gateway

The Amazon Pay gateway is a dynamic eCommerce solution that helps you create a seamless customer experience by offering more payment options, security features, and easy integration.

Supported Payment Methods

The Amazon Pay integration supports the following payment method:

Configure the Amazon Pay Gateway

  1. Click your username at the top right and navigate to Settings > Payments > Setup Payment Gateway.
  2. Select Amazon Pay from the Gateway Type drop-down list.
  3. Click create gateway.
  4. In the New Gateway configuration page, specify values for the gateway configuration fields.
  5. Click save gateway information.


Common Configuration Fields

There are some common fields you must complete for every gateway configuration. We recommend reviewing Setting Up Payment Gateways for information on these fields:

  • Name: Choose a name that identifies this payment gateway. We recommend using a name that helps your users identify the gateway.

  • Use Gateway Test Environment: Select this check box if you want Billing to use the payment gateway's test service URL. This allows you to test payment transactions while you are setting up your Billing.

The merchant must obtain the Seller ID and MWS Auth Token from their Amazon Seller Central prior to setting up the Amazon Pay gateway.

  • Store Name: The name entered in this field will appear as the store name in confirmation emails sent by Amazon to the customer

  • Seller Note: The note entered in this field will appear in emails from Amazon to the customer. It is a generic note and will be the same no matter what product the customer purchased.

  • Seller ID: This uniquely identifies the merchant. The merchant gets this identifier from Amazon Seller Central.

  • MWS Auth Token: This token is used to verify that we (Zuora) have permission to make API calls on behalf of the merchant identified by the Seller ID. This is obtained in Amazon Seller Central.

  • Default Authorization Amount: For this particular payment gateway, this field has no effect.

  • Verify new credit card (optional): Whether to verify the new credit card.

  • Verify updated credit card (optional): Whether to verify the updated credit card.

 After you have entered the necessary information, click save gateway information.



Credit Card Reference (CCRef) Transactions

Credit Card Reference transactions are payment transactions that utilize a transaction ID from a previously authorized transaction to process a subsequent payment. The transaction ID is a token that replaces sensitive payment method information (for example, a credit card or a bank account number) so the transaction ID/token is stored in Zuora as the payment method in place of sensitive card data or bank account information.  To use the CCRef payment method, contact Zuora Global Support to enable the CCRef for your tenant.

Configure the CCref Payment Method

This is the UI flow Zuora expects the Merchant to have set up on their website.

Quick reference:

Note: merchant only completes first 3 steps, then sends the billingAgreementId to Zuora, so we can complete the remaining steps.

The customer has a payment method with Amazon, and selects it with Widgets on the Merchant’s website. Zuora has no information about the payment method (credit card number, security code, billing address, etc.). These widgets also help to create the Billing Agreement. Detailed instructions on how to set up the widgets on a Merchant site can be found here. Note that the Merchant will only complete the first 3 steps on that page for this integration.

1. Login Widget


The user clicks this button to login to Amazon, after successfully logging in, the next widgets can be rendered.

2. Addressbook and Wallet Widget


Here, the user selects a shipping address which is stored in the Billing Agreement. If the merchant wishes not to use this widget, that is supported, and they should refer to this page. If that is not the case, then after the user selects an address from the AddressBook, the Wallet widget can be rendered.




With this widget, the user selects a payment method that will be stored in the Billing Agreement. Zuora will not be able to access information about this payment. Instead, we will use a token that is generated at the end of the user flow to authorize and capture on payment methods.

3. Repeat Payment Authorization Widget


This is the final widget in the user flow. It collects the user’s consent for recurring payments, and if it is not checked, then recurring payments will not be possible. After the user checks this box, the Billing Agreement will be ready for Zuora to manipulate and use for card validation, captures, voids, etc. At this point, the merchant should send Zuora the BillingAgreementId which they can get by calling getAmazonBillingAgreementId() on the billingAgreement object.

Activate Amazon Pay Payment Method

You must activate the Amazon Pay for your tenant before you can use this payment method. You can do this by clicking on your username and then select Payment settings >  Payments > Amazon Pay.

Last modified



(not set)