Skip to main content

Configure an Amazon Pay gateway instance


Configure an Amazon Pay gateway instance

The Amazon Pay gateway integration and payment method option are being deprecated in December 2023. You can no longer enable the Amazon Pay gateway integration if it is disabled. If you are using this integration, please switch to an alternative payment gateway integration and payment method before December 2023.

If you want to edit your existing gateway instance, follow the instructions in this article.


  1. Click your username at the top right and navigate to Settings > Payments > Setup Payment Gateway.
  2. On the Configure Gateway Instance tab, click Edit in the row of your existing Amazon Pay gateway instance.
  3. Edit the configuration of the instance.
  4. Click Save Gateway Information.

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.

    You 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: A description of the billing agreement that is included in the email sent when the billing agreement is confirmed. For example, “You have authorized TMG to use Amazon Pay for future purchases”. A maximum of 512 characters is allowed for this field. 

  • Seller Transaction Note: A description of the transaction that is included in the email sent when the fund is captured. For example, “Your unlimited access is now available”. A maximum of 255 characters is allowed for this field. 

  • Seller ID: This uniquely identifies the merchant. You get 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 you 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 payment method (optional): Whether to verify the new credit card.

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

Test the configuration

We recommend that you test your payment gateway by using both your payment gateway's sandbox and production (live) environments.  Once you have completed testing in the gateway's sandbox environment, it is recommended that you perform a test in your live production environment with real information. If there are any differences in the configuration of your sandbox and production accounts, testing in production ensures your production merchant account is set up properly and can successfully connect to the production environment.

You can use the testing scenarios provided by the gateway vendor to test your integration. See Amazon Pay's documentation for instructions on testing your integration.