Skip to main content

Tokenize SEPA payment methods on Adyen Integration v2.0

Zuora

Tokenize SEPA payment methods on Adyen Integration v2.0

  1. Last updated
  2. Save as PDF

To create tokenized SEPA payment methods, use one of the approaches described in this article.

Token field mapping

Adyen Field Zuora Field
shopperReference tokens > tokenId
recurringDetailReference tokens > secondTokenId

Approaches to creating tokenized SEPA payment methods

Approach Description Example
Use the Create a payment method API operation to tokenize IBAN

Pass in IBAN and set tokenize to true.

The tokens will be generated and stored in Zuora, and will be used in the subsequent recurring payments. 

 
{
   "IBAN": "NL13TEST0123456789",
   "accountKey": "402881868ab1b937018ab2314b91234a",
   "accountHolderInfo": {
     …
   },
   "type": "SEPA",
   "tokenize": true
}

Use the Create a payment method API operation to pass in existing tokens

Pass in shopperReference through tokens > tokenId.

Pass in recurringDetailReference through tokens > secondTokenId.

Pass in the masked account number through accountMaskNumber. 

Tokens will be stored in Zuora and used in the subsequent payments.

 
{
   "accountKey": "402881868ab1b937018ab2314b91234a",
   "accountHolderInfo": {
…
   },
   "type": "SEPA",
   "accountMaskNumber": "****1234",
   "tokens": {
     "gatewayType": "Adyen",
     "tokenId": "testTokenId",
     "secondTokenId": "testSecondTokenId"
   }
}

Tokenize payment methods when processing payments

 

 On the configuration page of your Adyen gateway instance, select Tokenize payment method. With this setting enabled, tokens will be generated for SEPA payment methods when processing payments through UI, API, or hosted payment page on Adyen Integration v2.0.  

 

Tokenizing SEPA payment methods through the preceding approaches is generally available in Sandbox environments. To enable it in Production environments, submit a request at Zuora Global Support.

Validate tokenized SEPA 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 gateway instance configuration page:

  • Verify new payment method
  • Verify updated payment method