# 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 |
| `alias` | ❌ | An alternative or commonly‑used name for the individual (e.g., preferred or informal name). Does not replace the legal name. |


### 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 |
| `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 at current address for less than 3 years, previous address details must 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` | ✅ | 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 details

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 |


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 |
| `tradingName` | ❌ | The trading common name of the sole trader |
| `taxIdentifier` | ❌ | The entity’s tax registration number (VAT, GST, EIN, TIN, or equivalent), depending on jurisdiction. |
| `alias` | ❌ | An alternative or commonly‑used name for the individual (e.g., preferred or informal name). Does not replace the legal name. |


### 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 |
| `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 at current address for less than 3 years, previous address details must be provided. Possible values: `true` and `false` |
| `previousHomeAddress` | ✅if `currentAddressLessThanThreeYears`: "true" | Address object. See `address` object above. |
| `isTradingAddressSameAsPrimary` | ✅ | If party resides at current address for less than 3 years, previous address details must be provided. Possible values: `true` and `false` |
| `tradingAddress` | ✅if `isTradingAddressSameAsPrimary`: "false" | 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` | ✅ | 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 details

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 |


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. |
| `taxIdentifier` | ❌ | The entity’s tax registration number (VAT, GST, EIN, TIN, or equivalent), depending on jurisdiction. |
| `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 |
|  --- | --- | --- |
| `address` | ✅ | Address object |
| `address1` | ✅ | Street/block and number |
| `address2` | ❌ | Additional information (like apartment number, floor or building number) |
| `city` | ✅ | City of company registration or headquarters |
| `state` | ❌ | State of company registration or headquarters |
| `countryCode` | ✅ | Country code of company registration or headquarters |
| `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 party. Possible values: `resident`,`nonResident` or `other` |
| `website` | ❌ | Website URL for this party |
| `currentAddressLessThanThreeYears` | ✅ | If party resides at current address for less than 3 years, previous address details must be provided. Possible values: `true` and `false` |
| `previousHomeAddress` | ✅if `currentAddressLessThanThreeYears`: "true" | Address object. See `address` object above. |
| `isTradingAddressSameAsPrimary` | ✅ | If party resides at current address for less than 3 years, previous address details must be provided. Possible values: `true` and `false` |
| `tradingAddress` | ✅if `isTradingAddressSameAsPrimary`: "false" | 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 |


### Financial details

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 |


### 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 |
| `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 at current address for less than 3 years, previous address details must 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` |
| `isPrincipalOwner` | ✅ | A flag indicating if the beneficial owner is also the principal owner for the company. Possible values: `true` or `false`. You have to set one, and no more than one beneficial owner per party record of type company, as principal owner. |
| `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` | ✅ | 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 |