Prerequisites
Before starting the onboarding process, ensure you have:- API credentials (Get your API key)
- Customer’s personal information
- Required documents in digital format (PDF, PNG, or JPEG)
Process overview
1
Create Customer Profile
Add the customer’s basic information
2
Upload Documents
Submit identity and proof of address documents
3
Start Verification
Initiate the KYC verification process
4
Monitor Status
Check verification progress and handle any issues
Step 1: Create an Individual Customer
Start by creating an individual customer profile with their basic information.Request
Required Fields
Field | Type | Description | Example |
---|---|---|---|
type | string | Must be "INDIVIDUAL" | "INDIVIDUAL" |
name | string | Customer’s full legal name | "John Doe" |
taxId | string | Valid tax ID for the country | "123.456.789-00" (CPF for Brazil) |
birthDate | string | Date of birth (YYYY-MM-DD) | "1990-01-01" |
country | string | ISO 3166-1 alpha-3 country code | "BRA" |
email | string | Valid email address | "john.doe@example.com" |
customerId
and a KYC link:
Response
You can either use the API endpoints or the
link
provided in the response
above to proceed with the next steps.Step 2: Upload Required Documents
Individual customers must provide identity verification and proof of address documents.Document requirements
1. Identity Document (Choose one)- National ID Card (
ID_CARD
) - front and back - Driver’s License (
DRIVERS_LICENSE
) - front and back - Passport (
PASSPORT
) - single page
- Must be dated within the last 3 months
- Shows full name and residential address
Upload Examples
File Requirements:
- Formats: PDF, PNG, or JPEG
- Maximum size: 50MB per document
- Documents must be clearly legible and fully visible
- Both physical (scanned) and digital documents are accepted
Step 3: Start KYC Verification
Once all documents are uploaded, initiate the KYC verification process:Request
Processing Time: Individual KYC verification is usually completed within
minutes, though it may take longer during peak times.
Step 4: Monitor Verification Status
Check the verification progress and results:Request
Response
Verification Statuses
Type | Description |
---|---|
NOT_STARTED | Verification hasn’t been initiated yet |
UNDER_VERIFICATION | Documents are being reviewed |
APPROVED | Customer is fully verified and ready to transact |
TEMPORARY_REJECTION | Documents need to be resubmitted |
FINAL_REJECTION | Customer was not approved |