End Users are your customers 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.

:exclamation:Incoming breaking change

From April 7th activation of a new End User (both Business and Individual End Users) will be fully asynchronous. This means that after a POST request the returned entity won't be with ACTIVE Status immediately, but CREATED. Activation will be asynchronous and based on our Compliance review process.

This may affect Virtual Account creation flow, since it's required that the End User for a new Virtual Account is ACTIVE. If it will not be implemented, the Virtual Account creation for End User can fail.

📘 NOTE: please ensure you use webhooks for implementation of the new flow.

Some of the fields below are not mandatory but highly recommend that you provide them to us to ensure smooth operations and minimal disruptions to your user's payments.

e.g. linkedCryptoWallets to aid in crypto transaction monitoring.

ipAddressIP address from where the user signed up on your platform.
linkedCryptoWallets.coinSymbol of the coin or token. e.g. BTC or ETH
linkedCryptoWallets.walletAddressBlockchain wallet address of the coin or token
linkedCryptoWallets.relationshipOne or more relationships between the End User and the walletId.

OWN - The End User's own wallet.
SENDER - The End User has sent value to the wallet
RECEIVER - The End User has received value from this wallet.
nationalityOne or more nationalities can be provided
tagsProvide PEP if the End User is a known PEP (Politically Exposed Person)
riskRatingRating of the risk level assigned to the user LOW, MEDIUM, HIGH
signupAtA date of registration of End User profile within Member platform timestamp

When you create Business End user all mandatory fields have to be provided as per below:

CompanyNameOfficial name of the company
Trading nameRequired even if the same as company name
TypeLegal type of the company - LLC, LTD etc
registrationNumberCompany registration number from the official registry
registrationDateDate when the company has been registered
registeredAddressAddress under which company has been registered in accordance with what is in the official documentation
tradingAddressRequired even if the same as the registered address
businessPersonsBoth DIRECTORS and UBO have to be provided. It can be the same person with 2 types provided at the same time. However once providing the information about the UBO, shareholder % has to be provided, e.g. 60% (just a numeric value has to be provided). Do not create the same person twice with the different type, e.g. when you create John Doe as a UBO and DIRECTOR he has to be added as one business person with 2 types provided. Also address and the email, along with the date of birth of the business persons are required.
IpAddressIP address from where the user signed up on your platform
sectorSector is required to understand the nature of the business of the business end user and make sure they are in line with the Fiat Republic risk appetite

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