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.

From April 7th activation of a new Business End User will be fully asynchronous. This means that after a POST request the returned entity won't be with ACTIVE Status immediately, but CREATED.

Check Guides for more details here

AttributeDescriptionFormat / ENUMS
id
string
Unique identifier of the Business End User.e.g. eus_j82rl497g47g5ykvzn
business.companyName
string
Official Company NameCan be built of multiple space separated segments
Cannot contain any of these special chars:
<!&|$*;^%_>#@="~
{}\
business.tradingName
string
Trading Company NameCan be built of multiple space separated segments
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
business.registeredAddress
string
Address under which company has been registered
business.registeredAddress.line1
string
First line of the company registration addressSpace and hyphen are allowed between the characters.
Max length 50
e.g. Silent Hill 123/34
business.registeredAddress.line2
string
Second line of the company registration addressSpace and hyphen are allowed between the characters.
Max length 50
business.registeredAddress.city
string
City of the registration addressSpace and hyphen are allowed between the characters.
Max length 50
e.g. London
business.registeredAddress.state
string
State or region of the registration addressSpace and hyphen are allowed between the characters.
Max length 35
e.g. Ile de France
business.registeredAddress.postalCode
string
Postal code of the registration addressThe 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 Estonia: ^\\d{5}\$
- for Ireland: (?:[AC-FHKNPRTV-Y][0-9]{2}|D6W)[ -]?[0-9AC-FHKNPRTV-Y]{4}$
- others: ^([^\\p{L}0-9]*?[\\p{L}0-9]){1,}\[\\.\\-\\s\\'\\/,()\\[\\]]*
business.registeredAddress.country
string
Country code of the registration addressThe 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 addressSpace and hyphen are allowed between the characters.
Max length 50
business.tradingAddress.line2
string
Second line of the company trading addressSpace and hyphen are allowed between the characters.
Max length 50
business.tradingAddress.city
string
City of the company trading addressSpace and hyphen are allowed between the characters.
Max length 50
business.tradingAddress.state
string
State of the company trading addressSpace and hyphen are allowed between the characters.
Max length 35
business.tradingAddress.postalCode
string
Postal code of the company trading addressThe 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 Estonia: ^\\d{5}\$
- for Ireland: (?:[AC-FHKNPRTV-Y][0-9]{2}|D6W)[ -]?[0-9AC-FHKNPRTV-Y]{4}$
- others: ^([^\\p{L}0-9]*?[\\p{L}0-9]){1,}\[\\.\\-\\s\\'\\/,()\\[\\]]*
business.tradingAddress.country
string
Country od the company trading addressThe two-letter code used to identify a country.
ISO 3166-1 alpha-2 country code e.g. GB or US
Can be built of singular value.
Must have only letters, hyphens and apostrophes.
First name of the Business Person.Can be built of singular value.
Must have only letters, hyphens and apostrophes.
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.
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.
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
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
business.businessPersons.person.address.city
string
City of the Business Person.Space and hyphen are allowed between the characters.
Max length 50
business.businessPersons.person.address.state
string
Region or state of the Business Person.Space and hyphen are allowed between the characters.
Max length 35
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 Estonia: ^\\d{5}\$
- for Ireland: (?:[AC-FHKNPRTV-Y][0-9]{2}|D6W)[ -]?[0-9AC-FHKNPRTV-Y]{4}$
- others: ^([^\\p{L}0-9]*?[\\p{L}0-9]){1,}\[\\.\\-\\s\\'\\/,()\\[\\]]*
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
The + is required
business.businessPersons.person.email
string
Email of the Business Person.This is required
business.businessPersons.types
string
Type of the Business Person. Can be CONTACT, DIRECTOR or 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
business.linkedCryptoWallets
string
Details of any known crypto wallets linked with the individual being created.
business.tags
string
Tags allowing you to provide additional risk-related information for the individual.PEP
business.sector
string
Sector in which business operatese.g. crypto, blockchain
business.riskRating
string
Rating of the risk level assigned to the user.LOW, MEDIUM, HIGH
business.signupAt
integer
A date of registration of End User profile within Member platforme.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,ACTIVE, REJECTED

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