Account Key

string

optional

The customer account ID (for example, 2x92c0f859b0480f0159d3a4a6ee5bb6) or customer account number (for example, A02855638).

To create an orphan payment method not associated with any customer account, omit this field. Once the account information is available, associate the payment method with an account using the Update Payment Method operation.

Account Mask Number

string

optional

The masked account number such as ****1234.

Account Holder Info Account Holder Name*

string <= 60 characters

required

The full name of the bank account holder.

Account Holder Info Address Line1

string

optional

The primary address line for the account holder.

Account Holder Info Address Line2

string

optional

The secondary address line for the account holder.

Account Holder Info City

string

optional

The city where the account holder resides. Providing the city and country during payment method creation is recommended, as this information is used for payment processing. If not provided, the city and country details will be unavailable during processing.

Account Holder Info Country

string

optional

The country where the account holder resides.

Account Holder Info Email

string

optional

The account holder's email address.

Account Holder Info First Name

string

optional

The account holder's first name.

Account Holder Info Last Name

string

optional

The account holder's last name.

Account Holder Info Phone

string

optional

The account holder's phone number.

Account Holder Info State

string

optional

The state where the account holder resides.

Account Holder Info Zip Code

string

optional

The ZIP/postal code for the account holder's address.

Auth Gateway

string

optional

The internal ID of the payment gateway that Zuora uses to authorize payments made with this payment method.

If this field is not set, Zuora uses the default payment gateway of the customer account associated with the payment method when the accountKey is specified; otherwise, it uses the default payment gateway configured for the Zuora tenant.

Business Identification Code

string

Required to Create

The BIC code used for SEPA

Currency Code

string

optional

The currency used to authorize payments for the payment method.

IBAN*

string

optional

The International Bank Account Number. This field is required if the type field is set to SEPA. However, for the creation of tokenized SEPA payment methods, this field is optional. Currently, SEPA tokenization is supported on selected payment gateway integrations.

IP Address

string

optional

Specifies the user's IPv4 or IPv6 address at the time the payment method is created or updated. Some payment gateways use this information for fraud prevention, and Zuora passes the value directly to the gateway if provided.

The IP address must not exceed 45 characters, or a validation error will occur. This field is required when validating SEPA payment methods on Stripe v2.

makeDefault

boolean

optional

Default: false.

Mandate Info Mandate Id

string <= 36 characters

optional

The mandate ID.

Mandate Info Mandate Reason

string <= 64 characters

optional

The reason of the mandate from the gateway side.

Mandate Info Mandate Status

string <= 64 characters

optional

The status of the mandate as provided by the payment gateway.

Processing Options Check Duplicated

boolean

optional

Indicates whether to perform a duplication check when creating a payment method. The default is false. When set to true, Zuora checks both active and closed payment methods associated with the same billing account to prevent duplicates.

For more information, see Duplication check on payment methods.

Skip Validation

boolean

optional

Default: false.

Specifies whether to skip validation through the payment gateway. For example, set this field to true when migrating payment methods to bypass validation.

Type*

string

required

Type of the payment method.

Tokens Token Id*

string

required

Pass in the first token of the payment method

Tokenize

boolean

optional

Default: false

When creating a SEPA payment method using Adyen Integration v2.0, this field indicates whether the payment method should be tokenized using the IBAN. If set to true, the IBAN field is required. If the tokens field is provided, this field is not required. For more information, see Tokenize SEPA payment methods on Adyen Integration v2.0.

Tokens gateway Type*

string

required

The type of the payment gateway to generate the tokens. This field is case-sensitive. Enum: Adyen, Stripe.

Tokens Second Token Id

string

optional

Pass in the second token of the payment method

Tokens Third Token Id

string

optional

Pass in the third token of the payment method