Welcome to Zuora Product Documentation

Explore our rich library of product information

Supported payment methods

Learn how to integrate Amazon Pay with Zuora for Credit Card Reference Transactions, utilizing transaction IDs for secure payment processing.

The Amazon Pay gateway integration supports Credit Card Reference 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 or 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.

This is the UI flow Zuora expects you to set up on your website.

Quick reference: https://pay.amazon.com/us/developer/documentation/automatic/201757210

You only need to complete the first 3 steps, then send the billingAgreementId to Zuora. Zuora can complete the remaining steps for you.

The customer has a payment method with Amazon and selects it with Widgets on your website. Zuora does not store any information about the payment method, for example, credit card number, security code, billing address, and so on. These widgets also help to create the Billing Agreement . Detailed instructions on how to set up the widgets on your site can be found here .

  1. Login Widget amaonPay2.png The user clicks this button to login to Amazon. After successfully logging in, the next widgets can be rendered.
  2. Addressbook and Wallet Widget amazonPay3.png The user selects a shipping address which is stored in the Billing Agreement. If you do not want to use this widget, refer to this article for more information. If that is not the case, then after the user selects an address from the AddressBook, the Wallet widget can be rendered. amazonPay4.png 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 amazonPay5.png 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, you should send Zuora the BillingAgreementId which you can get by calling getAmazonBillingAgreementId() on the billingAgreement object.