Complete KYB Workflow

Step-by-Step Process

1. Create Business Customer

POST /v1/customers/business

Include basic business info. KYB process starts automatically.

2. (Optional) Add/Update Shareholders

POST /v1/customers/business/{id}/shareholders

Add shareholders via the dedicated CRUD endpoints.

3. Get Required Documents

GET /v1/meta/kyb/documents

Get the list of required documents for the business jurisdiction.

4. Upload Required Documents

POST /v1/customers/business/{id}/documents

Upload each required document (base64 encoded). Returns 201 on success, 409 if document type already exists.

5. Check Verification Status

GET /v1/customers/business/{id}

Monitor verificationStatus field until approved or rejected.

Enhanced Due Diligence (EDD) Triggers

EDD may be required for:

• High-risk jurisdictions
• High-risk verticals (gaming, trading, crypto exchanges)
• Complex ownership structures
• Expected monthly volume exceeding thresholds
• Operations involving sanctioned countries

Outcome: KYB approval, conditional approval with caps, or rejection.

Verification Timeline

Common Rejection Reasons