This section explains the KYC process for individuals.
You should start by following the steps from the development quick start guide and creating an identity.
In addition to passing your personal details, please note that you must set the following parameters when creating an identity:
identityType - Individuals must create an identity first, setting this parameter as
companyOfficer - This parameter must be set to
true if the person is a Company Officer and wishes to create and verify a company account.
If you create a person identity with the flag
companyOfficer set to
true, then the verification will not be created until you finish the company's
identity creation process. For more information check the KYC for companies section.
After that, a verification will be created (this may take a moment). At this point you can optionally check the status of the verifications by making a call to the
With the identity created, then it’s time to associate documents so that we can verify the validity of the data you inserted.
All users must verify their identities by submitting official documents before being allowed to deposit or withdraw. This requires you to upload digitized copies of your (or your customers') government id and proof of address in JPG, PNG, or PDF format.
To upload files you must send a request to the documents endpoint of type
multipart/form-data. The request should contain a link to the file you like to upload, as well as the parameters for creating a file.
Please refer to the FAQs for a list of accepted documents and upload guidelines.
After you submit the documents, they're automatically sent to our KYC provider for verification.
Please note that the result may take some time - ranging from a few minutes to a few days depending on your country of residence, the type and the country of issuance of your documents.
To check if KYC was successful, make a
GET request to the
/identities:id endpoint and pass the
id of the identity as a parameter along in the body. If
verificationStatus = 'approved' then you've passed it.
Alternatively, if you're a user who manages multiple identities, you can make a request to your
/identities endpoint and then filter the results by
After the provider concludes the KYC process, the
verificationStatus attribute will change to
'approved' and you (or your customer) will be allowed to conduct fiat transactions.
If you're a company, you still need to get verified as a business. Read on to learn how.