cardHolderInfo

address

string

Optional

Cardholder's address line 1.
Maximum 100 characters.

address2

string

Optional

Cardholder's address line 2.
Maximum 100 characters.

city

string

Optional

Cardholder's city.
Maximum 42 characters.

companyName

string

Optional

The cardholder's company name. Maximum 100 characters.

country

string

Optional

Cardholder's country code.
Refer to Country codes

email

string

Required for local LatAm processing only

Cardholder's email address.
Maximum 100 characters.

firstName

string

Optional

Cardholder'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.

lastName

string

Optional

Cardholder's last name.
Maximum 100 characters.

merchantShopperId

string

Optional

A merchant's ID for a specific shopper.
Maximum 50 characters.

personalIdentificationNumber

string

Required 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)

phone

string

Optional

Cardholder's phone number.

Minimum requirements: 5 numeric characters, with the following exceptions:

• USA: 10 characters

• Denmark, Greenland, and Iceland: 8 characters

Maximum requirements: Combination of 36 alphanumeric characters and the following special characters:
+ . * # / \ ( ) –“

Note: American Express recommends that you send the cardholder's phone number to improve authorization rates.

state

string

Optional

Cardholder'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.

zip

string

Optional

Cardholder's ZIP code.
Maximum 20 characters.

address

string

Cardholder's address line 1.
Maximum 100 characters.

address2

string

Cardholder's address line 2.
Maximum 100 characters.

city

string

Cardholder's city.
Maximum 42 characters.

companyName

string

The cardholder's company name. Maximum 100 characters.

country

string

Cardholder's country code.
Refer to Country codes

email

string

Cardholder's email address.
Maximum 100 characters.

firstName

string

Cardholder's first name.
Maximum 100 characters.

lastName

string

Cardholder's last name.
Maximum 100 characters.

merchantShopperId

string

A merchant's ID for a specific shopper.
Maximum 50 characters.

personalIdentificationNumber

string

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)

phone

string

Cardholder's phone number.
Maximum 36 characters.

state

string

Cardholder's state code.
Refer to State and province codes

zip

string

Cardholder's ZIP code.