- 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 |
state | ❌ | State of residence |
countryCode | ✅ | Country code 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 | ✅ | Required if identityDocuments object provided. Type of the identity document. Possible values: passport, nationalId or tax ID |
number | ✅ | Required if identityDocuments object provided. Number of the identity document |
issuingInstitution | ✅ | Required if identityDocuments object provided. Institution that issued the identity document |
issuingCountry | ✅ | Required if identityDocuments object provided. Country where the identity document was issued |
validFrom | ✅ | Required if identityDocuments object provided. Date when the identity document was issued |
validTo | ✅ | Required if identityDocuments object provided. 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 | ✅ | Either accountNumber or iban are required. Bank account number of the party's bank account |
iban | ✅ | Either accountNumber or iban are required. 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 |