Customer Details

This is an example with all customer fields:

Smart Transaction
{
// ...
"customer": {
"contact": {
"companyname": "Musterfirma GmbH",
"salutation": "Mr.",
"forename": "Max",
"surname": "Mustermann",
"name": "Max Mustermann",
"address": {
"street": "Max-Muster-Str.",
"street_number": "25a",
"additional_address_data": "Whg. 202",
"postal_code": "09555",
"city": "Musterstadt",
"country": "DE"
},
"email": "max25@example.net",
"mobile": "+49 177 5555555",
"phone": "+49 555 5555555",
     "dob": "1965-12-31T00:00:00+01:00"
}
}
// ...
}

These are the fields inside customer/contact:

Field

Type

Meaning

companyname

string

Optional company name.

salutation

string

Optional salutation.

forename

string

First name.

surname

string

Last name.

name

string

Readonly full name.

address

object

Optional residential address.

address/street

string

Street without house number.

address/street_number

string

Optional house number, for example "5" or "112-114 b".

address/additional_address_data

string

Optional address addition, for example "App. 201" or "c/o Erika Musterfrau".

address/postal_code

string

Optional ZIP code.

address/city

string

Optional city.

address/country

string

Optional two-letter country code (e. g. DE).

email

string

Email address.

phone

string

Optional phone number, e. g. +49 555 5555555.

mobile

string

Optional mobile phone number, e. g. +49 151 5555555.

dob

string

Optional date of birth. Especially helpful for risk analysis for some payment methods.

The only mandatory fields are first_name, last_name and email. If there is an address you can only omit the house number and the additional address line.