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. |
business.companyName | Official Company Name | Can be built of multiple space separated segments |
business.tradingName | Trading Company Name | Can be built of multiple space separated segments |
business.type | Type of the business (Limited only) | LIMITED |
business.registrationNumber | Company registration number | e.g. 56292646 |
business.registrationDate | Date when the company has been registered | |
business.website | Company website | Validation regex: JavaScript: |
business.registeredAddress | Address under which company has been registered | Is required |
business.registeredAddress.line1 | First line of the company registration address | Space and hyphen are allowed between the characters. |
business.registeredAddress.line2 | Second line of the company registration address | Space and hyphen are allowed between the characters. |
business.registeredAddress.city | City of the registration address | Space and hyphen are allowed between the characters. |
business.registeredAddress.state | State or region of the registration address | Space and hyphen are allowed between the characters. |
business.registeredAddress.postalCode | Postal code of the registration address | The format and presence of this field may vary depending on the country.
|
business.registeredAddress.country | Country code of the registration address | The two-letter code used to identify a country. |
business.tradingAddress | Trading address of the company (might be the same as registration address) | |
business.tradingAddress.line1 | First line of the company trading address | Space and hyphen are allowed between the characters. |
business.tradingAddress.line2 | Second line of the company trading address | Space and hyphen are allowed between the characters. |
business.tradingAddress.city | City of the company trading address | Space and hyphen are allowed between the characters. |
business.tradingAddress.state | State of the company trading address | Space and hyphen are allowed between the characters. |
business.tradingAddress.postalCode | Postal code of the company trading address | The format and presence of this field may vary depending on the country.
|
business.tradingAddress.country | Country od the company trading address | The two-letter code used to identify a country. |
business.businessPersons.person.firstName | First name of the Business Person. | Can be built of singular value. |
business.businessPersons.person.middleName | Middle name of the Business Person. | Can be built of multiple space separated segments. |
business.businessPersons.person.lastName | Last name of the Business Person. | Can be built of multiple space separated segments. |
business.businessPersons.person.birthCountry | Country of birth of the Business Person. | The two-letter code used to identify a country. |
business.businessPersons.person.nationality | One or more nationalities of the Business Person. | The two-letter code used to identify a country. |
business.businessPersons.person.dob | Date of birth of the Business Person. |
|
business.businessPersons.person.address.line1 | First line of the Business Person's home address. | Space and hyphen are allowed between the characters. |
business.businessPersons.person.address.line2 | Second line of the Business Person's home address. | Space and hyphen are allowed between the characters. |
business.businessPersons.person.address.city | City of the Business Person. | Space and hyphen are allowed between the characters. |
business.businessPersons.person.address.state | Region or state of the Business Person. | Space and hyphen are allowed between the characters. |
business.businessPersons.person.address.postalCode | Postal/Zip code of the Business Person. | The format and presence of this field may vary depending on the country.
|
business.businessPersons.person.address.country | Business Person's Country of residence. | The two-letter code used to identify a country. |
business.businessPersons.person.phone | Phone number of the Business Person. | Including the country prefix e.g. - must start with a plus sign (+).
|
business.businessPersons.person.email | Email of the Business Person. | This is required |
| Number of identity document | |
| Type of identity document | Examples: |
business.businessPersons.types | Type of the Business Person. Can be CONTACT / DIRECTOR / UBO | There must be at least 1 DIRECTOR and 1 UBO |
business.businessPersons.ownership | Amount of shares hold by the Business Person (in %) | e.g. 50.00 |
business.createdAt | Epoch Timestamp at which the object was last updated. | e.g. |
business.updatedAt | Epoch Timestamp at which the object was last updated. | e.g. |
business.ipAddress | The IP address from where the individual signed up on your platform. | e.g. 86.23.22.163 |
annualTurnoverRange | Value of annual turnover range of the Business End User (in EUR) | Ranges:
|
linkedCryptoWallets | Details of any known crypto wallets linked with the individual being created. | |
tags | Tags allowing you to provide additional risk-related information for the individual. |
|
sector | Sector in which business operates | e.g. crypto, blockchain |
riskRating | Rating of the risk level assigned to the user. |
|
signupAt | A date of registration of End User profile within Member platform | e.g. |
metadata | Additional data in JSON key:value format. | See Metadata for more information |
status | Status of the Business End User. |
|
After creating an Business End User, you will be able to create one or more Virtual Accounts for them.