Individuals
Everything you need to know in order to verify an individual customer
As a financial institution, Fin must perform checks on users who want to transact using fiat currencies (USD, SGD, EUR, GBP etc.)
The verification process is the following:
1. Basic information:
Field | Description |
|---|---|
| Legal first name (as per ID). |
| Legal last name (as per ID). |
| Date of birth. |
| Valid personal or business email. |
| Mobile number including country code (e.g., |
| Country where the person currently resides. |
| Citizenship of the person. |
| Tax Identification Number or equivalent. If a customer doesn't have a tin number, please enter the passport or identity document number here. Jurisdiction specific tin format is mandatory:
|
2. Address:
Please note this has to be the current residential address of the user.
| Field | Description |
|---|---|
street | Full street address (house/building + road). |
city | City or locality name. |
state | Subdivision or state (use ISO-3166-2 format). |
postal_code | Postal or ZIP code. |
country | Country code of residence. |
3. Financial Profile:
| Field | Description |
|---|---|
occupation_id | ID representing the person’s occupation (from Occupations). |
source_of_fund_id | ID representing where funds originate (from Source of funds). |
purpose_id | ID representing the purpose of using the service (from Account purposes). |
monthly_volume_usd | Estimated average monthly transaction amount in USD. |
4. Metadata:
| Field | Description |
|---|---|
reference | Developer or system-generated reference ID. |
5. Uploading documents:
In order to submit documents to us for verification, it is required to be uploaded via the Upload a document to the system in our system first and then utilize the Attach documents for an individual customerto attach it for verification for an individual customer.
6. Attaching documents:
| Field | Description |
|---|---|
customer_id | Unique identifier returned from the individual KYC creation API. |
6.1 Proof of identity:
| Field | Description |
|---|---|
type | Type of ID document. Allowed: PASSPORT, NATIONAL_ID, DRIVING_LICENSE, RESIDENCE_PERMIT. |
number | Document number as shown on the ID. |
country | Country of issuance. |
issue_date | Date of issuance (if available on document). |
expiry_date | Document expiry date (if applicable). |
files | List of uploaded file objects. |
File object:
| Field | Description |
|---|---|
side | FRONT or BACK |
uri | URI returned from the file upload API. |
6.2 Proof of Address:
| Field | Description |
|---|---|
type | Document type. Allowed: BANK_STATEMENT, UTILITY_BILL, GOVERNMENT_LETTER, PASSPORT, NATIONAL_ID, DRIVERS_LICENSE, RESIDENCE_PERMIT. The document must have the full provided address of the customer with their full name on it. |
country | Country of issuance or residence, has to match the country_of_residence |
files | List of uploaded file objects. |
File object:
| Field | Description |
|---|---|
uri | URI returned from the file upload API. |
Accepting terms of services and privacy policies:
| Field | Description |
|---|---|
tos_policies_value | Retrieve from the response of the Create an individual customer profilewhere you will find the tos_policies_url, within that that url you will find the tos_policies_value |
Developer Notes
- All country fields must follow ISO Alpha-3 codes (e.g., BGD, SGP, USA).
- Use predefined drop-down for
occupation_id,source_of_fund_id, andpurpose_id. monthly_volume_usdis an estimated activity level, not account balance.- The API enforces field presence, types, and value validation automatically.
- For IDs with both sides (like national IDs), include two file objects: FRONT and BACK.
- File URIs must be generated from the Upload a document to the system API before attachment.
- Proof of address must be issued within the last 90 days.
Updated 5 days ago
