cardHolderInfo

Contains information about the credit card holder

Request

Property NameTypeRequiredDescription
firstNamestringOptionalCardholder's first name.
Maximum 100 characters.

Note: On your checkout form, if you collect both first and last name in the same input field (i.e., Name field), you can split the input value on the space (" ") character to separate it.
lastNamestringOptionalCardholder's last name.
Maximum 100 characters.
emailstringRequired for local LatAm processing onlyCardholder's email address.
Maximum 100 characters.
countrystringOptionalCardholder's country code.
Refer to Country codes
statestringOptionalCardholder's state code.
Refer to State and province codes.
Supports US and Canada states only. For states in other countries, it is necessary to include the state within the address property.
addressstringOptionalCardholder's address line 1.
Maximum 100 characters.
address2stringOptionalCardholder's address line 2.
Maximum 100 characters.
citystringOptionalCardholder's city.
Maximum 42 characters.
zipstringOptionalCardholder's ZIP code.
Maximum 20 characters.
phonestringOptionalCardholder's phone number.

Minimum Characters:
- USA: 10 characters
- Denmark, Greenland, Iceland: 8 characters
- Other countries: 5 characters.

Maximum Characters: 36 characters

Accepts numbers, letters, and these characters: + . * # / \ ( ) –“
merchantShopperIdstringOptionalA merchant's ID for a specific shopper.
Maximum 50 characters.
personalIdentificationNumberstringRequired for local LatAm processing in Brazil; Optional for all other Latam countries.The shopper's local personal identification number. These are the ID types per country:

Argentina: DNI (length 7–11 chars)
Brazil: CPF/CNPJ (length 11–14 chars)
Chile: RUN (length 8–9 chars)
Mexico: CURP/RFC (length 10–18 chars)
companyNamestringOptionalThe cardholder's company name. Maximum 100 characters.

Response

Property NameTypeDescription
firstNamestringCardholder's first name.
Maximum 100 characters.
lastNamestringCardholder's last name.
Maximum 100 characters.
emailstringCardholder's email address.
Maximum 100 characters.
countrystringCardholder's country code.
Refer to Country codes
statestringCardholder's state code.
Refer to State and province codes
addressstringCardholder's address line 1.
Maximum 100 characters.
address2stringCardholder's address line 2.
Maximum 100 characters.
citystringCardholder's city.
Maximum 42 characters.
zipstringCardholder's ZIP code.
phonestringCardholder's phone number.
Maximum 36 characters.
merchantShopperIdstringA merchant's ID for a specific shopper.
Maximum 50 characters.
personalIdentificationNumberstringThe shopper's local personal identification number.
These are the ID types per country:

Argentina: DNI (length 7–11 chars)
Brazil: CPF/CNPJ (length 11–14 chars)
Chile: RUN (length 8–9 chars)
Mexico: CURP/RFC (length 10–18 chars)
companyNamestringThe cardholder's company name. Maximum 100 characters.