Welcome to Zuora Product Documentation

Explore our rich library of product information

Tokenize SEPA payment methods

To create tokenized SEPA payment methods, use one of the following approaches:

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 and ACH payment methods when processing payments through UI, API, or hosted payment page on Adyen Integration v2.0.

Note:

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.