CustomerInfo | ePay documentation

Customer info. These data points are used during SCA/3DS and is required for some schemes. These data may also be sent to the specific payment provider, if required to complete the payment such as Klarna. It is recommended to send all the info that is available to improve the approval rate.

firstNamestring

Nullable

The first name of the paying customer.

Length:

1 <= length

Example:

"Peter"

lastNamestring

Nullable

The last name of the paying customer.

Length:

1 <= length

Example:

"Nielsen"

birthdatestring

Nullable

The date of birth of the cardholder in YYYY-MM-DD format.

Format:

date

Example:

"2000-07-25"

emailstring

Nullable

The email of the paying customer.

Length:

1 <= length

Example:

"email@example.com"

phoneNumberstring

Nullable

E.164 phone number format with a single space between country code and local number. No additional spaces allowed.

Format: "+[countryCode] [number]".

Match:

^\+\d{1,3} \d+$

Example:

"+45 12345678"

The shipping address of the purchase. If no wares are shipped, leave this empty. If billing and shipping address is the same, then fill both properties with identical information.

countryCodestring

Nullable

ISO 3166-1 alpha-2 country code

Length:

2 <= length <= 2

Example:

"DK"

postalCodestring

Nullable

The local postal code of the address

Length:

1 <= length <= 16

Example:

"1400"

citystring

Nullable

The city

Length:

1 <= length <= 50

Example:

"København"

line1string

Nullable

The first address line. Most address only has a singular line.

Length:

1 <= length <= 50

Example:

"Torvegade 45"

line2string

Nullable

Second address line. Only use if address contains multiple lines. Always start with line1.

Length:

1 <= length <= 50

Example:

"2. th."

line3string

Nullable

Third address line. Only use if address contains multiple lines. Always start with line1 and line2.

Length:

1 <= length <= 50

Example:

"Christianshavn"

The billing address of the customer. Often the personal address of the customer or the business address of paying company. If billing and shipping address is the same, then fill both properties with identical information.

countryCodestring

Nullable

ISO 3166-1 alpha-2 country code

Length:

2 <= length <= 2

Example:

"DK"

postalCodestring

Nullable

The local postal code of the address

Length:

1 <= length <= 16

Example:

"1400"

citystring

Nullable

The city

Length:

1 <= length <= 50

Example:

"København"

line1string

Nullable

The first address line. Most address only has a singular line.

Length:

1 <= length <= 50

Example:

"Torvegade 45"

line2string

Nullable

Second address line. Only use if address contains multiple lines. Always start with line1.

Length:

1 <= length <= 50

Example:

"2. th."

line3string

Nullable

Third address line. Only use if address contains multiple lines. Always start with line1 and line2.

Length:

1 <= length <= 50

Example:

"Christianshavn"

CustomerInfo

{  "firstName": "Peter",  "lastName": "Nielsen",  "birthdate": "2000-07-25",  "email": "email@example.com",  "phoneNumber": "+45 12345678",  "shippingAddress": {    "countryCode": "DK",    "postalCode": "1400",    "city": "København",    "line1": "Torvegade 45"  },  "billingAddress": {    "countryCode": "DK",    "postalCode": "1400",    "city": "København",    "line1": "Torvegade 45"  }}