Credit Card fields
This reference lists the credit card and related fields available on Zuora payment pages, including names, labels, types, limits, allowed values, and usage notes.
| Field Name (case sensitive) | Default Field Label | Type | Maximum Length | Allowed Values | Notes |
|---|---|---|---|---|---|
| creditCardExpirationMonth | Expiration Date | String | 2 | "1" through "12" | Zuora recommends making this field required. |
| creditCardExpirationYear | String | 4 | Zuora recommends making this field required. | ||
| creditCardType | Card Type | String | 20 |
| Zuora recommends making this field required. |
| creditCardNumber | Card Number | String | 32 | Zuora recommends making this field required. Although a maximum of 32 characters are allowed in this form field, Zuora only supports 13–16 digit card numbers. | |
| cardSecurityCode | CVV | String | 4 | Zuora recommends making this field required. | |
| creditCardHolderName | Cardholder Name | String | 50 | Zuora recommends making this field required. For the integration with the CyberSource gateway, when passing this field to the gateway, the string value of this field is split into first name and last name with the first space in the string. | |
| creditCardCountry | Country | String | 3 | 3-digit ISO code | For a complete list of supported ISO country codes, see View countries or regions. |
| creditCardState | State | String | 50 | State or province | |
| creditCardAddress1 | Address 1 | String | 255 | ||
| creditCardAddress2 | Address 2 | String | 255 | ||
| creditCardCity | City | String | 40 | ||
| creditCardPostalCode | Postal Code | String | 20 | The maximum length and allowed values for this field vary by payment gateways. To find out specific requirements:
| |
| ipAddress | N/A | String | 128 | The IP address of the user when the payment method was created or updated. Some gateways use this field for fraud prevention. Both IPv4 and IPv6 are supported. This field is hidden and does not appear on the form. | |
| phone | Contact Phone Number | String | 40 | ||
| Email Address | String | 80 | |||
| identityNumber | Identity Number | String | 20 | This field is used to capture the Tax Identification Numbers (For example, CPF/CNPJ in Brazil) of end customers in Latin America. When configuring the payment page, you can customize the field label of Identity Number for better clarity. For example, update the field label to CPF/CNPJ Number for your Brazilian customers. The following gateway integrations support using this field to capture the Tax Identification Numbers:
|