- Person - A natural person providing goods and/or services on merchant's platform. A human being with legal rights and obligations, subject to personal liability in legal terms.
 
Basic details of the person representing the party
| Field | Required? | Description | 
|---|---|---|
title | ❌ | Title of the party. Possible values: mr, mrs, miss, ms, dr, mx or misc | 
firstName | ✅ | First name | 
middleName | ❌ | Middle name | 
lastName | ✅ | Last name | 
dateOfBirth | ✅ | Date of birth | 
nationality | ✅ | Nationality | 
Address details of residence of the person representing the party.
| Field | Required? | Description | 
|---|---|---|
address | ✅ | Address object | 
address1 | ✅ | Street/block and number | 
address2 | ❌ | Additional information (like apartment number, floor or building number) | 
city | ✅ | City of residence | 
country | ✅ | Country of residence | 
postalCode | ❌ | Postal or ZIP code for this address | 
addressType | ✅ | Type of address. Possible values: home,office,PObox or other | 
residentialStatus | ✅ | The residential status of this person. Possible values: resident,nonResident or other | 
website | ❌ | Website URL for this party | 
currentAddressLessThanThreeYears | ✅ | If party resides on current address for less than 3 years, previous address details must be be provided. Possible values: true and false | 
previousHomeAddress | ✅ if currentAddressLessThanThreeYears: "true" | Address object. See address object above. | 
Phone numbers and email details of the person representing the party.
| Field | Required? | Description | 
|---|---|---|
email | ❌ | Email address of the party | 
phones | ❌ | Phone object | 
number | ❌ | Phone number of the party | 
prefix | ✅  if number is provided | Prefix for the phone number of the party | 
Details on identity documents of the person representing the party.
| Field | Required? | Description | 
|---|---|---|
identityDocuments | ✅ | Identity documents object | 
type | ✅ | Type of the identity document. Possible values: passport, nationalId or tax ID | 
number | ✅ | Number of the identity document | 
issuingInstitution | ✅ | Institution that issued the identity document | 
issuingCountry | ✅ | Country where the identity document was issued | 
validFrom | ✅ | Date when the identity document was issued | 
validTo | ✅ | Date until the identity document is valid to | 
Financial (bank and other) details of the person representing the party:
| Field | Required? | Description | 
|---|---|---|
accountHolderName | ✅ | Name of the bank account owner | 
accountNumber | ✅ | Bank account number of the party's bank account | 
iban | ✅ | IBAN of the party's bank account | 
bankName | ✅  | Name of the party's bank account | 
bankCode | ✅ | Bank code of party's bank account | 
swiftBic | ✅ | SWIFT/BIC of party's bank account |