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.
Alternatively, you can add existing Adyen tokens 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. recurringDetailReference 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.
When you create a Credit Card Reference Transaction payment method using the Create a Payment Method API operation on Adyen v2.0 and set skipValidation to false, Zuora validates the information you provide with Adyen. If secondTokenId does not match any recurringDetailReference associated with the shopperReference specified through the tokenId field, the first recurringDetailReference of the shopperReference is used to create the payment method. This recurringDetailReference is saved as secondTokenId in Zuora for processing payments.
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.