Skip to main content

Credit Card Reference Transactions on Adyen Integration v2.0


Credit Card Reference Transactions on Adyen Integration v2.0

Zuora supports Adyen tokens. Tokens are used for credit card reference transactions in Zuora. A reference transaction is simply a representation of a credit card payment method without having sensitive payment method information like the credit card number stored in Zuora. The token cannot be used with another gateway, which is why Zuora recommends storing credit card information in Zuora whenever possible.

Create tokens

For Adyen Integration v2.0, you can enter credit card information and Zuora will create tokens (shopperReference and recurringDetailReference) for you when the following requirements are met:

  • The credit card was validated through Adyen Integration v2.0.
  • The credit card was used to process payments through Adyen Integration v2.0.

Apart from credit card tokens, you can also add an existing Adyen token in Zuora. To use an existing token, enter the shopperReference token in the Token Id field, and the recurringDetailReference information you want to use in the Second Token Id field when creating or updating a tokenized payment method. After recurringDetailReference is entered, it will be saved by Zuora and used for all payments made with this payment method. 

Since each merchant can have multiple recurringDetailReferences per shopperReference in Adyen, the best practice is to always specify recurringDetailReference for tokenized payment methods. If you have existing tokenized payment methods without the recurringDetailsReference information, we recommend that you update all these payment methods to include recurringDetailReference in the Second Token ID field. For example, you can use Zuora's Developer Tools app to mass update all payment methods stored in Zuora.

Adyen recommends that you either use existing Adyen tokens or create tokens from Zuora by entering the credit card information for all credit card reference transactions in a consistent manner. Do not use both ways to create tokenized payment methods.

For tokenized payment methods, you must validate them in Zuora so that payments made with these payment methods are successful. To validate tokenized payment methods, enable the following settings on the Adyen Integration v2.0 gateway configuration page:

  • Verify new payment method
  • Verify updated payment method

Export tokens

To export Token Id and Second Token Id, use the Payment Method data source.