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.