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. You can enter credit card information and Zuora will create tokens for you.

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