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 Individual 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
Individual End User Object
Attribute | Description | Format / ENUMS |
---|---|---|
id string | Unique identifier of the End User. | e.g. |
person.firstName | First name of the End User. | Can be built of multiple space separated segments. |
person.middleName | Middle names of the End User | Can be built of multiple space separated segments. |
person.lastName | Last name of the End User. | Can be built of multiple space separated segments. |
person.address.line1 | First line of the End User home address. | Space and hyphen are allowed between the characters. |
person.address.line2 | Second line of the End User's home address. | Space and hyphen are allowed between the characters. |
person.address.city | City of the End User. | Space and hyphen are allowed between the characters. |
person.address.state | Region or state of the End User. | Space and hyphen are allowed between the characters. |
person.address.postalCode | Postal/Zip code of the End User. | Validation regex:
|
person.address.country | End User's Country of residence. | Two-letter ISO 3166-1 alpha-2 country code e.g. |
person.email | Email address of the End User. | |
person.phone | Phone number of the End User. | Including the country prefix e.g. - must start with a plus sign (+).
|
person.birthCountry | Country of birth of the End User. | Two-letter ISO 3166-1 alpha-2 country code e.g. |
person.nationality | One or more nationalities of the End User. | Two-letter ISO 3166-1 alpha-2 country code e.g. |
person.identificationDocument.number | Number of identity document | |
person.identificationDocument.type | Type of identity document | Examples: |
person.dob | Date of birth of the End User. |
|
ipAddress | The IP address from where the individual signed up on your platform. | e.g. 86.23.22.163 |
annualSalaryRange | Value of annual salary of the Individual End User (in EUR) | Ranges:
|
tags | Tags allowing you to provide additional risk-related information for the individual. |
|
status | Status of the End User. |
|
createdAt | Epoch Timestamp at which the object was created. | e.g. |
updatedAt | Epoch Timestamp at which the object was last updated. | e.g. |
metadata | Additional data in JSON | See Metadata for more information |
linkedCryptoWallets | Details of any known crypto wallets linked with the individual being created. | |
linkedCryptoWallets.coin | Symbol of the coin or token. | e.g. |
linkedCryptoWallets.walletAddress | Blockchain wallet address of the coin or token. | e.g |
linkedCryptoWallets.relationship | One or more relationships between the individual and the walletAddress. |
|
riskRating | Rating of the risk level assigned to the user. |
|
signupAt | A date of registration of End User profile within Member platform | e.g. |
After creating an Individual End User, you will be able to create one or more Virtual Accounts for them.