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. `eus_j82rl497g47g5ykvzn`
person.firstName string	First name of the End User.	Can be built of multiple space separated segments. Must have only letters, hyphens and apostrophes. Regex: `^[a-zA-Z](?:[a-zA-Z '.-]*[a-zA-Z])?\.?$`
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. Regex: `^[a-zA-Z](?:[a-zA-Z '.-]*[a-zA-Z])?\.?$`
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. Regex: `^'?[a-zA-Z]([ a-zA-Z'-]*[a-zA-Z])?$`
person.address.line1 string	First line of the End User 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 .'\-/,)(⁰°#"]$`
person.address.line2 string	Second line of the End User'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 .'\-/,)(⁰°#"]$`
person.address.city string	City of the End User.	Space and hyphen are allowed between the characters. Max length 50 Regex: `^[a-zA-Z0-9 .'\-/,][a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,]$`
person.address.state string	Region or state of the End User. Required for entity with address in CA and US	Space and hyphen are allowed between the characters. Max length 35 Regex: `^[a-zA-Z0-9 .'\-/,)(+][a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(+]$`
person.address.postalCode string	Postal/Zip code of the End User.	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]$`
person.address.country string	End User's Country of residence. Once provided, cannot be changed.	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` must start with a plus sign (+). should have country code (e.g., +1, +44, etc.) followed by the appropriate number of digits (min = 8, max = 15)
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`
person.identificationDocument.number	Number of identity document
person.identificationDocument.type	Type of identity document	Examples: `WORK_PERMIT`, `PASSPORT`, `NATIONAL_ID`, `DRIVERS_LICENCE`
person.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
annualSalaryRange string	Value of annual salary of the Individual End User (in EUR)	Ranges: 0 to 25000 25000 to 50000 50000 to 100000 100000 to 150000 above 150000
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` , `IN_REVIEW`,`ACTIVE`, `SUSPENDED`,`REJECTED`, `CLOSED`
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.