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.
Individual End User Object
Attribute | Description | Format / ENUMS |
---|---|---|
id string | Unique identifier of the End User. | e.g. eus_j82rl497g47g5ykvzn |
person.firstName string | First name of the End User. | Can be built of singular value. Must have only letters, hyphens and apostrophes. |
person.middleName string | Middle names of the End User | Can be built of multiple space separated segments. Should be between 1 and 100 characters long and contain only letters, hyphens, dots and apostrophes. |
person.lastName string | Last name of the End User. | Can be built of multiple space separated segments. Must consist of words that have only letters, hyphens and apostrophes. |
person.address.line1 string | First line of the End User home address. | |
person.address.line2 string | Second line of the End User's home address. | |
person.address.city string | City of the End User. | |
person.address.state string | Region or state of the End User. | |
person.address.postalCode string | Postal/Zip code of the End User. | 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\\'\\/,()\\[\\]]* |
person.address.country string | End User's Country of residence. | Two-letter ISO 3166-1 alpha-2 country code e.g. GB or US |
person.email string | Email address of the End User. | |
person.phone string | Phone number of the End User. | Including the country prefix e.g. +447788661100 |
person.birthCountry string | Country of birth of the End User. | Two-letter ISO 3166-1 alpha-2 country code e.g. FR or CA |
person.nationality array of strings | One or more nationalities of the End User. | Two-letter ISO 3166-1 alpha-2 country code e.g. AU or BE |
dob date | Date of birth of the End User. | YYYY-MM-DD format e.g. 1975-04-05 |
ipAddress string | The IP address from where the individual signed up on your platform. | e.g. 86.23.22.163 |
tags array of strings | Tags allowing you to provide additional risk-related information for the individual. | PEP |
status string | Status of the End User. | CREATED or ACTIVE |
createdAt integer | Epoch Timestamp at which the object was created. | e.g. 1637049210552 |
updatedAt integer | Epoch Timestamp at which the object was last updated. | e.g. 1637049210552 |
metadata array of strings | Additional data in JSON key:value format. | See Metadata for more information |
linkedCryptoWallets array of objects | Details of any known crypto wallets linked with the individual being created. | |
linkedCryptoWallets.coin string | Symbol of the coin or token. | e.g. BTC |
linkedCryptoWallets.walletAddress string | Blockchain wallet address of the coin or token. | e.g 3d1f7363-f6b3-1705-le5c-e4dfc7k8192n |
linkedCryptoWallets.relationship array of strings | One or more relationships between the individual and the walletAddress. | OWN , SENDER or RECEIVER |
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 |
After creating an Individual End User, you will be able to create one or more Virtual Accounts for them.