# United Kingdom

Person
- **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

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

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. |


### Phones/emails details

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 |


### Identity documents details

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 details

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 |


Sole trader
- **Sole trader** - A self-employed individual, a sole proprietor, who runs a business under their own name or a registered trade name. The business is not a separate legal entity, meaning the owner is subject to personal liability in legal terms.


### Basic details

Basic details of the sole trader 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 |
| `merchantCategoryCode` | ✅ | MCC of the Sole Trader |
| `merchantCategoryCodeDescription` | ✅ | MCC description of the Sole Trader |


### Address details

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. |


### Phones/emails details

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 |


### Identity documents details

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 details

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 |


Company
- **Company** - A  business structure that represents a legal entity, and is legally separate from its owners. Includes all types of legal entities other than **person** or **sole trader**.


### Basic details

Basic details of the company representing the party

| Field | Required? | Description |
|  --- | --- | --- |
| `legalName` | ✅ | The legal name of the company |
| `tradingName` | ✅ | The trading common name of the company |
| `registrationNumber` | ✅ | The registration number for the company. What should be supplied in this field may differ by country, for instance in the United States it will be a Tax Id. Number (TIN) |
| `vatNumber` | ❌ | The Value Added Tax (VAT) number of the company |
| `companyType` | ✅ | A Description of the type of company. Possible values: `charity`, `government`, `publicLimitedCompany`, `limitedCompanyShares`, `limitedLiabilityPartnership`, `partnership`, `limitedCompanyGuarantee`, `trust`, `regulatedFinancialAndCreditInstitutions`, `unlistedCorporate`, `publicBodies`, `subsidiaryOfPubliclyListedCorporate`, `nonProfit`, `estatesOfDeceasedPerson`, `secRegistered`, `clubsOrSocieties`, `subsidiaryOfRegulatedFinancialAndCreditInstitutions`, `other`. |
| `dateOfIncorporation` | ✅ | The incorporation date for the company |
| `countryOfIncorporation` | ✅ | The incorporation country for the company |
| `merchantCategoryCode` | ✅ | MCC of the company |
| `merchantCategoryCodeDescription` | ✅ | MCC description of the company |


### Address details

Address details of residence of the person representing the party.

| Field | Required? | Description |
|  --- | --- | --- |
| `legalAddress` | ✅ | The Legal address object |
| `tradingAddress` | ✅ | The Trading 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` |
| `website` | ❌ | Website URL for this party |


### Phones/emails details

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 |


### Beneficial owners details

Details on beneficial owners of the company representing the party.

#### Basic details

Basic details of the beneficial owner.

| 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

Address details of residence of the beneficial owner.

| 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. |


#### Relationship to business details

Details of the beneficial owner's business relationship to the company.

| Field | Required? | Description |
|  --- | --- | --- |
| `ownershipPercentage` | ✅ | Percentage of the ownership of the beneficial owner over the company. |
| `director` | ✅ | A flag indicating if the beneficial owner is also a `director` for the company. Possible values: `true` or `false` |
| `position` | ✅ | Type of position of the beneficial owner within the company. Possible values: `soleTrader`,`accountant`,`bursar`,`chairman`,`chairwoman`,`chiefExecutiveOfficer`,`clerk`,`companySecretary`,`creditController`,`deputyLeader`,`generalManager`,`leader`,`manager`,`managingDirector`,`master`,`guarantor`,`mayor`,`officeManager`,`operationsManager`,`president`,`principal`,`proprietor`,`townClerk`,`director`,`apportionmentAndOversight`,`chiefExecutive`,`complianceOversight`,`directorUnincorporatedAssociate`,`nonExecutiveDirector`,`significantManagement`,`smallFriendlySociety`,`chairperson`,`designatedMember`,`secretary`,`trustee`,`treasurer`,`businessRepresentative`,`authorisedSignatory`,`signatory`,`technicalContact`,`contractSignatory`,`publicOfficer`,`controller`,`beneficialOwner`,`partner`,`shareholder`,`chiefFinancialOfficer`,`chiefOperatingOfficer`,`beneficiary`,`charitySecretary`,`member`,`protector`,`settlor`,`soleProprietor`,`nonDesignatedMember` |


#### Phones/emails details

Phone numbers and email details of the beneficial owner.

| 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 |


#### Identity documents details

Details on identity documents of the beneficial owner.

| 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 |