The Business End User Object

Business End User Object

End Users are your users who should be created on Fiat Republic before you can start receiving or sending payments for them. We require a minimum set of details on your customers to fulfil our regulatory obligations and perform AML checks.

Activation of a new Business End User is fully asynchronous. This means that after a POST request the returned entity won't be with ACTIVE Status immediately, but CREATED.

To enable USD for End Users, please find requirements gathered here Enabling USD Services

Check Guides for more details here

Attribute

Description

Format / ENUMS

id string

Unique identifier of the Business End User.

e.g. eus_j82rl497g47g5ykvzn

business.companyName
string

Official Company Name

Can be built of multiple space separated segments
Regex: [a-zA-Z0-9\s',£€¥'':/«»"".?\-+()]+

business.tradingName
string

Trading Company Name

Can be built of multiple space separated segments
Regex: [a-zA-Z0-9\s',£€¥'':/«»"".?\-+()]+

business.type
string

Type of the business (Limited only)

LIMITED

business.registrationNumber
string

Company registration number

e.g. 56292646

business.registrationDate
LocalDate

Date when the company has been registered

business.website
string

Company website

Validation regex: ((http(s)?)://)?(www\\.)?[a-zA-Z0-9\\-_.~]{2,256}(\\.[a-zA-Z]{2,6})(/\[a-zA-Z0-9!#$&'()\*+,/:;=?@\\[\\]\\-\_.~]{2,})?

JavaScript:
("^((http(s)?)://)?(www\\.)?[a-zA-Z0-9\\-_.~]{2,256}(\\.[a-zA-Z]{2,6})(/\[a-zA-Z0-9!#$&'()\*+,/:;=?@\\[\\]\\-\_.~]{2,})?$");

business.registeredAddress
string

Address under which company has been registered

Is required

business.registeredAddress.line1
string

First line of the company registration address

Space and hyphen are allowed between the characters.
Max length 50
e.g. Silent Hill 123/34
Regex: ^[a-zA-Z0-9 .'\-/,]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,]*$

business.registeredAddress.line2
string

Second line of the company registration address

Space and hyphen are allowed between the characters.
Max length 50
Regex: ^[a-zA-Z0-9 .'\-/,]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,]*$

business.registeredAddress.city
string

City of the registration address

Space and hyphen are allowed between the characters.
Max length 50
e.g. London
Regex: ^[a-zA-Z0-9 .'\-/,]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,]*$

business.registeredAddress.state
string

State or region of the registration address

Space and hyphen are allowed between the characters.
Max length 35
e.g. Ile de France
Regex: ^[a-zA-Z0-9 .'\-/,)(+]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(+]*$

business.registeredAddress.postalCode
string

Postal code of the registration address

The format and presence of this field may vary depending on the country.
Space and hyphen are allowed between the characters. Please trim spaces at the end
Validation regex:

  • for GB: ^[a-zA-Z]{1,2}[0-9R][0-9a-zA-Z]? ?[0-9][a-zA-Z]{2}$
  • for Estonia: ^\d{5}$
  • for Ireland: (?:[AC-FHKNPRTV-Y][0-9]{2}\|D6W)[ -]?[0-9AC-FHKNPRTV-Y]{4}$
  • others: ^[a-zA-Z\d][a-zA-Z\s\d\-]{1,8}[a-zA-Z\d]$

business.registeredAddress.country
string

Country code of the registration address

The two-letter code used to identify a country.
ISO 3166-1 alpha-2 country code e.g. GB or US

business.tradingAddress
string

Trading address of the company (might be the same as registration address)

business.tradingAddress.line1
string

First line of the company trading address

Space and hyphen are allowed between the characters.
Max length 50
Regex: ^[a-zA-Z0-9 .'\-/,)(⁰°#"]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(⁰°#"]*$

business.tradingAddress.line2
string

Second line of the company trading address

Space and hyphen are allowed between the characters.
Max length 50
Regex: ^[a-zA-Z0-9 .'\-/,)(⁰°#"]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(⁰°#"]*$

business.tradingAddress.city
string

City of the company trading address

Space and hyphen are allowed between the characters.
Max length 50
Regex: ^[a-zA-Z0-9 .'\-/,]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,]*$

business.tradingAddress.state
string

State of the company trading address

Space and hyphen are allowed between the characters.
Max length 35
Regex: ^[a-zA-Z0-9 .'\-/,)(+]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(+]*$

business.tradingAddress.postalCode
string

Postal code of the company trading address

The format and presence of this field may vary depending on the country.
Space and hyphen are allowed between the characters. Please trim spaces at the end
e.g. 67999, 30-555, SW1A 1AA
Validation regex:

  • for GB: ^[a-zA-Z]{1,2}[0-9R][0-9a-zA-Z]? ?[0-9][a-zA-Z]{2}$
  • for Estonia: ^\d{5}$
  • for Ireland: (?:[AC-FHKNPRTV-Y][0-9]{2}\|D6W)[ -]?[0-9AC-FHKNPRTV-Y]{4}$
  • others: ^[a-zA-Z\d][a-zA-Z\s\d\-]{1,8}[a-zA-Z\d]$

business.tradingAddress.country
string

Country od the company trading address

The two-letter code used to identify a country.
ISO 3166-1 alpha-2 country code e.g. GB or US

business.businessPersons.person.firstName

First name of the Business Person.

Can be built of singular value.
Must have only letters, hyphens and apostrophes.
Regex:^[a-zA-Z](?:[a-zA-Z '.-]*[a-zA-Z])?\.?$

business.businessPersons.person.middleName
string

Middle name of the Business Person.

Can be built of multiple space separated segments.
Should be between 1 and 100 characters long and contain only letters, hyphens, dots and apostrophes.
Regex: ^[a-zA-Z](?:[a-zA-Z '.-]*[a-zA-Z])?\.?$

business.businessPersons.person.lastName
string

Last name of the Business Person.

Can be built of multiple space separated segments.
Must consist of words that have only letters, hyphens and apostrophes.
Regex: ^'?[a-zA-Z]([ a-zA-Z'-]*[a-zA-Z])?$

business.businessPersons.person.birthCountry
string

Country of birth of the Business Person.

The two-letter code used to identify a country.
ISO 3166-1 alpha-2 country code e.g. GB or US

business.businessPersons.person.nationality
array of strings

One or more nationalities of the Business Person.

The two-letter code used to identify a country.
ISO 3166-1 alpha-2 country code e.g. GB or US

business.businessPersons.person.dob
Date

Date of birth of the Business Person.

YYYY-MM-DD format e.g. 1975-04-05

business.businessPersons.person.address.line1
string

First line of the Business Person's home address.

Space and hyphen are allowed between the characters.
Max length 50
Regex: ^[a-zA-Z0-9 .'\-/,)(⁰°#"]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(⁰°#"]*$

business.businessPersons.person.address.line2
string

Second line of the Business Person's home address.

Space and hyphen are allowed between the characters.
Max length 50
Regex: ^[a-zA-Z0-9 .'\-/,)(⁰°#"]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(⁰°#"]*$

business.businessPersons.person.address.city
string

City of the Business Person.

Space and hyphen are allowed between the characters.
Max length 50
Regex: ^[a-zA-Z0-9 .'\-/,]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,]*$

business.businessPersons.person.address.state
string

Region or state of the Business Person.

Space and hyphen are allowed between the characters.
Max length 35
Regex: ^[a-zA-Z0-9 .'\-/,)(+]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(+]*$

business.businessPersons.person.address.postalCode
string

Postal/Zip code of the Business Person.

The format and presence of this field may vary depending on the country.
Space and hyphen are allowed between the characters. Please trim spaces at the end
e.g. 67999, 30-555, SW1A 1AA
Validation regex:

  • for GB: ^[a-zA-Z]{1,2}[0-9R][0-9a-zA-Z]? ?[0-9][a-zA-Z]{2}$
  • for Estonia: ^\d{5}$
  • for Ireland: (?:[AC-FHKNPRTV-Y][0-9]{2}\|D6W)[ -]?[0-9AC-FHKNPRTV-Y]{4}$
  • others: ^[a-zA-Z\d][a-zA-Z\s\d\-]{1,8}[a-zA-Z\d]$

business.businessPersons.person.address.country
string

Business Person's Country of residence.

The two-letter code used to identify a country.
ISO 3166-1 alpha-2 country code e.g. GB or US

business.businessPersons.person.phone
string

Phone number of the Business Person.

Including the country prefix e.g. +447788661100

- must start with a plus sign (+).

  • should have country code (e.g., +1, +44, etc.) followed by the appropriate number of digits (min = 8, ma

business.businessPersons.person.email
string

Email of the Business Person.

This is required

  • *business.businessPersons.person.
    identificationDocument.number**

Number of identity document

  • *business.businessPersons.person.
    identificationDocument.type**

Type of identity document

Examples:
WORK_PERMIT,
PASSPORT,
NATIONAL_ID,
DRIVERS_LICENCE

business.businessPersons.types
string

Type of the Business Person. Can be CONTACT / DIRECTOR / UBO

There must be at least 1 DIRECTOR and 1 UBO

business.businessPersons.ownership
BigDecimal

Amount of shares hold by the Business Person (in %)

e.g. 50.00

business.createdAt
integer

Epoch Timestamp at which the object was last updated.

e.g. 1637049210552

business.updatedAt
integer

Epoch Timestamp at which the object was last updated.

e.g. 1637049210552

business.ipAddress
string

The IP address from where the individual signed up on your platform.

e.g. 86.23.22.163

annualTurnoverRange
string

Value of annual turnover range of the Business End User (in EUR)

Ranges:

  • 0 to 50000
  • 50000 to 250000
  • 250000 to 1000000
  • 1000000 to 5000000
  • above 5000000

linkedCryptoWallets
string

Details of any known crypto wallets linked with the individual being created.

tags
string

Tags allowing you to provide additional risk-related information for the individual.

PEP

sector
string

Sector in which business operates

e.g. crypto, blockchain

riskRating
string

Rating of the risk level assigned to the user.

LOW, MEDIUM, HIGH

signupAt
integer

A date of registration of End User profile within Member platform

e.g. 1637049210552

metadata
array of strings

Additional data in JSON key:value format.

See Metadata for more information

status
string

Status of the Business End User.

CREATED , IN_REVIEW,ACTIVE, SUSPENDED,REJECTED, CLOSED

After creating an Business End User, you will be able to create one or more Virtual Accounts for them.