Prerequisites
Before starting the onboarding process, ensure you have:- API credentials (Get your API key)
- Business legal information and documentation
- Beneficiary information (for owners with 20%+ shares)
- Required documents in digital format (PDF, PNG, or JPEG)
Process overview
1
Create Business Profile
Register business and beneficiary information
2
Upload Business Documents
Submit incorporation and business proof of address
3
Upload Beneficiary Documents
Submit KYC documents for each 20%+ owner
4
Start KYB Verification
Initiate the business verification process
5
Monitor Status
Track verification for business and all beneficiaries
Step 1: Create a Business Customer
Create a business customer profile with company and beneficiary information.Request
Required Fields
Field | Type | Description | Example |
---|---|---|---|
type | string | Must be "BUSINESS" | "BUSINESS" |
legalName | string | Company’s legal registered name | "Acme Corporation" |
taxId | string | Valid business tax ID | "12.345.678/0001-00" (CNPJ for Brazil) |
incorporationDate | string | Date of incorporation (YYYY-MM-DD) | "2020-01-01" |
country | string | ISO 3166-1 alpha-3 country code | "BRA" |
email | string | Business contact email | "contact@acme.com" |
beneficiaries | array | List of beneficiaries with 20%+ ownership | See beneficiary structure below |
Beneficiary Structure
Each beneficiary must include:Field | Type | Description | Example |
---|---|---|---|
type | string | Must be "INDIVIDUAL" | "INDIVIDUAL" |
name | string | Beneficiary’s full legal name | "Jane Smith" |
taxId | string | Beneficiary’s personal tax ID | "987.654.321-00" |
birthDate | string | Date of birth (YYYY-MM-DD) | "1985-05-15" |
country | string | ISO 3166-1 alpha-3 country code | "BRA" |
email | string | Beneficiary’s email | "jane@acme.com" |
sharePercentage | number | Ownership percentage (must be ≥20) | 30 |
Include all beneficiaries with 20%+ ownership. Each requires KYC documents.
customerId
, beneficiary IDs, and a KYB link:
Response
You can either use the API endpoints or the
links
provided in the response
above to proceed with the next steps. For businesses with other businesses as
beneficiaries, only link
is supported.Step 2: Upload Required Documents
Business customers require corporate documents and KYC documents for each beneficiary.Business Documents Required
1. Legal Incorporation Documents- Articles of Incorporation (
INCORPORATION_ARTICLES
) - Certificate of Formation
- State Business Registration Extract
- Incumbency Certificate (
INCUMBENCY_CERT
) - Shareholder Registry (
SHAREHOLDER_REGISTRY
)
- Must be dated within last 3 months
Beneficiary Documents Required
For each beneficiary with 20%+ ownership: 1. Identity Document (Choose One)- National ID Card (front and back)
- Driver’s License (front and back)
- Passport
- Must be dated within the last 3 months
Upload Examples
Upload documents for ALL beneficiaries with 20%+ ownership.
File Requirements:
- Formats: PDF, PNG, or JPEG
- Maximum size: 50MB per document
- Documents must be clearly legible and fully visible
- Official documents must be properly certified if required
Step 3: Start KYB Verification
Once all business and beneficiary documents are uploaded, initiate the KYB verification:Request
Processing Time: Business KYB verification typically takes up to 24 hours,
though it may take longer during peak times.
Step 4: Monitor Verification Status
Check the verification progress for both the business and its beneficiaries: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 |
Businesses must be approved along with ALL beneficiaries for full
verification.