KYB Business Details Request

namestringrequired

Business legal name.

Possible values: <= 60 characters

Example: Test Company

idstringrequired

Merchant business identifier.

Possible values: <= 20 characters

Example: BID1234567

registered_numberstringrequired

Business registration number.

Possible values: <= 50 characters

Example: REG123456789

addressstringrequired

Business address.

Possible values: <= 105 characters

Example: Company Street

citystringrequired

Business city.

Possible values: <= 60 characters

Example: Company City

postcodestringrequired

Business postal code.

Possible values: <= 10 characters

Example: 12354

country_iso2stringrequired

Two-letter ISO 3166-1 country code.

Possible values: >= 2 characters and <= 2 characters, Value must match regular expression ^[A-Z]{2}$

Example: AT

phone_numberstringrequired

Business phone number.

Possible values: <= 20 characters

Example: +1234567890

emailstring<email>required

Business email address.

Possible values: <= 255 characters

Example: test@company.com

mccstringrequired

Merchant category code.

Possible values: <= 10 characters

Example: 5551

associates object[]required

Business associates such as UBOs, directors, and representatives.

Array [

first_namestringrequired

Associate first name.

Possible values: <= 60 characters

Example: First

last_namestringrequired

Associate last name.

Possible values: <= 60 characters

Example: Last

date_of_birthstring<date>required

Associate date of birth in ISO 8601 format (YYYY-MM-DD).

Example: 1980-10-20

addressstringrequired

Associate address.

Possible values: <= 105 characters

Example: Street 24

citystringrequired

Associate city.

Possible values: <= 60 characters

Example: City

postcodestringrequired

Associate postal code.

Possible values: <= 10 characters

Example: 12345

country_iso2stringrequired

Two-letter ISO 3166-1 country code.

Possible values: >= 2 characters and <= 2 characters, Value must match regular expression ^[A-Z]{2}$

Example: AT

rolesstring[]required

Associate roles within the business.

The maximum count allowed per role is 3 UBO, 4 DIRECTOR and 3 REPRESENTATIVE.

Possible values: [UBO, DIRECTOR, REPRESENTATIVE]

Example: ["UBO","DIRECTOR","REPRESENTATIVE"]

]

parent_companies object[]required

Parent companies in the ownership structure.

Array [

namestringrequired

Parent company name.

Possible values: <= 60 characters

Example: Test Parent Company

registered_numberstringrequired

Parent company registration number.

Possible values: <= 50 characters

Example: REPPRNT123

addressstringrequired

Parent company address.

Possible values: <= 105 characters

Example: Parent Address 123

citystringrequired

Parent company city.

Possible values: <= 60 characters

Example: Parent City

postcodestringrequired

Parent company postal code.

Possible values: <= 10 characters

Example: 14789

country_iso2stringrequired

Two-letter ISO 3166-1 country code.

Possible values: >= 2 characters and <= 2 characters, Value must match regular expression ^[A-Z]{2}$

Example: AT

phone_numberstringrequired

Parent company phone number.

Possible values: <= 20 characters

Example: +1234567890

emailstring<email>required

Parent company email address.

Possible values: <= 255 characters

Example: test-parent@company.com

associates object[]

Associates linked to the parent company.

Array [

first_namestringrequired

Associate first name.

Possible values: <= 60 characters

Example: First

last_namestringrequired

Associate last name.

Possible values: <= 60 characters

Example: Last

date_of_birthstring<date>required

Associate date of birth in ISO 8601 format (YYYY-MM-DD).

Example: 1980-10-20

addressstringrequired

Associate address.

Possible values: <= 105 characters

Example: Street 24

citystringrequired

Associate city.

Possible values: <= 60 characters

Example: City

postcodestringrequired

Associate postal code.

Possible values: <= 10 characters

Example: 12345

country_iso2stringrequired

Two-letter ISO 3166-1 country code.

Possible values: >= 2 characters and <= 2 characters, Value must match regular expression ^[A-Z]{2}$

Example: AT

rolesstring[]required

Associate roles within the business.

The maximum count allowed per role is 3 UBO, 4 DIRECTOR and 3 REPRESENTATIVE.

Possible values: [UBO, DIRECTOR, REPRESENTATIVE]

Example: ["UBO","DIRECTOR","REPRESENTATIVE"]

]

]

KYB Business Details Request

{
  "name": "Test Company",
  "id": "BID1234567",
  "registered_number": "REG123456789",
  "address": "Company Street",
  "city": "Company City",
  "postcode": "12354",
  "country_iso2": "AT",
  "phone_number": "+1234567890",
  "email": "test@company.com",
  "mcc": "5551",
  "associates": [
    {
      "first_name": "First",
      "last_name": "Last",
      "date_of_birth": "1980-10-20",
      "address": "Street 24",
      "city": "City",
      "postcode": "12345",
      "country_iso2": "AT",
      "roles": [
        "UBO",
        "DIRECTOR",
        "REPRESENTATIVE"
      ]
    }
  ],
  "parent_companies": [
    {
      "name": "Test Parent Company",
      "registered_number": "REPPRNT123",
      "address": "Parent Address 123",
      "city": "Parent City",
      "postcode": "14789",
      "country_iso2": "AT",
      "phone_number": "+1234567890",
      "email": "test-parent@company.com",
      "associates": [
        {
          "first_name": "First",
          "last_name": "Last",
          "date_of_birth": "1980-10-20",
          "address": "Street 24",
          "city": "City",
          "postcode": "12345",
          "country_iso2": "AT",
          "roles": [
            "UBO",
            "DIRECTOR",
            "REPRESENTATIVE"
          ]
        }
      ]
    }
  ]
}