Welcome to Zuora Product Documentation

Explore our rich library of product information

Tokenize ACH payment methods

Note:

To enable tokenizing ACH payment methods on Adyen Integration v2.0, submit a request at Zuora Global Support .

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

Approach

Description

Example

Use an API operation that supports payment method creation, such as Create a payment method , to tokenize raw account information

Pass in the following required account information and set tokenize to true :

  • type

  • bankABACode

  • bankAccountName

  • bankAccountNumber

  • bankAccountType

  • bankName

Tokens are generated and stored in Zuora, and used in the subsequent recurring payments.

{
  "accountKey":"8a8d90b9936821cd0193685a12080000",
  "bankAccountNumber": "123456789",
  "bankABACode": "121000358",
  "bankAccountName": "Test Bank",
  "bankAccountType": "Checking",
  "bankName": "active",
  "phone": "334343",
  "email": "email@test.com",
  "addressLine1": "Test Plaza", 
  "addressLine2": "Byway Street",
  "city": "Fremont",
  "country": "CA",
  "state": "Ontario",
  "zipCode": "94020",
  "type": "ACH",
  "tokenize": true
}

Use an API operation that supports payment method creation, such as Create a payment method , to pass in existing tokens

Pass in the following required fields:

  • type

  • bankABACode

  • bankAccountName

  • bankAccountType

  • bankName

Pass in shopperReference through tokens > tokenId .

Pass in recurringDetailReference through tokens > secondTokenId .

Pass in the masked account number through bankAccountMaskNumber .

Tokens are stored in Zuora and used in subsequent payments.

{
  "accountKey":"8a8d90b9936821cd0193685a12080000",
  "bankABACode": "121000358",
  "bankAccountName": "Test Bank",
  "bankAccountType": "Checking",
  "bankName": "active",
  "phone": "334343",
  "email": "test@email.com",
  "addressLine1": "Test Plaza", 
  "addressLine2": "Byway Street",
  "city": "Fremont",
  "country": "CA",
  "state": "Ontario",
  "zipCode": "94020",
  "type": "ACH",
  "bankAccountMaskNumber": "12***6789",
  "tokens": {
        "gatewayType": "Adyen",
        "tokenId": "A00000001",
        "secondTokenId": "S8P8RZDBMBTVZZ00"
    }
}

Use an API operation that supports payment method creation, such as Create a payment method , to pass in existing tokens and raw card information

Pass in the following required card information:

  • type

  • bankABACode

  • bankAccountName

  • bankAccountNumber

  • bankAccountType

  • bankName

Pass in shopperReference through tokens > tokenId .

Pass in recurringDetailReference through tokens > secondTokenId .

Pass in the masked account number through bankAccountMaskNumber .

Tokens are stored in Zuora and used in subsequent payments.

{
  "accountKey":"8a8d90b9936821cd0193685a12080000",
  "bankAccountNumber": "123456789",
  "bankABACode": "121000358",
  "bankAccountName": "Test Bank",
  "bankAccountType": "Checking",
  "bankName": "active",
  "phone": "334343",
  "email": "test@email.com",
  "addressLine1": "Test Plaza", 
  "addressLine2": "Byway Street",
  "city": "Fremont",
  "country": "CA",
  "state": "Ontario",
  "zipCode": "94020",
  "type": "ACH",
  "bankAccountMaskNumber": "12***6789",
  "tokens": {
        "gatewayType": "Adyen",
        "tokenId": "A00000001",
        "secondTokenId": "S8P8RZDBMBTVZZ00"
    }
}

Tokenize payment methods when processing payments

On the configuration page of your Adyen Integration v2.0 gateway instance, select Tokenize payment method . With this setting enabled, tokens are generated and stored for ACH and SEPA payment methods when processing payments through UI, API, or Payment Pages 2.0.