Completing the KYC
Identity verification flows for user onboarding and feature access.
Before You Start
Read the following guides before proceeding:
| Guide | Why |
|---|---|
| Getting Started | Platform overview and setup |
| Api Basics | Required headers and request configuration |
| Authentication | How to obtain access tokens |
| Webhooks | Receive status notifications |
| Onboarding | User and wallet registration |
| User Profile | User capabilities and status |
KYC (Know Your Customer) verification is required before users can access financial features in Wirex BaaS. Verification determines which capabilities become available to users, including bank accounts, card issuance, and transfer limits.
Wirex supports three verification flows depending on your existing infrastructure and user experience requirements:
| Flow | Use Case |
|---|---|
| Wirex Hosted | Wirex handles verification; users complete KYC in Wirex UI |
| SumSub Shared | Share existing SumSub verification with Wirex |
| Reliance | You handle KYC; provide verified data via API |
Verification Levels
| Level | Description | Unlocks |
|---|---|---|
| BDD | Basic Due Diligence | Account creation, limited features |
| SDD | Standard Due Diligence | Bank accounts, cards, standard transfers |
| EDD | Enhanced Due Diligence | Higher limits, additional features |
Verification Flow
sequenceDiagram
participant User
participant App as Your App
participant BaaS as Wirex BaaS
participant KYC as KYC Provider
Note over User,KYC: Registration
User->>App: Sign up
App->>BaaS: POST /api/v2/user
BaaS-->>App: user_id
Note over User,KYC: Verification
App->>KYC: User completes KYC
KYC->>BaaS: Verification result
BaaS->>App: POST /webhook/users<br/>(verification_status)
Note over App,BaaS: Check Capabilities
App->>BaaS: GET /api/v2/user
BaaS-->>App: capabilities[]
| Step | Action | Description |
|---|---|---|
| 1 | POST /api/v2/user | Register user with initial data or shared verification |
| 2 | KYC completion | User completes verification via chosen flow |
| 3 | Webhook | Receive verification status updates |
| 4 | GET /api/v2/user | Check updated capabilities |
Choosing a Flow
Wirex Hosted
- You collect minimal user data (email, country)
- Users are redirected to Wirex/SumSub interface for verification
- Wirex handles the entire KYC process
- Best for: Partners without existing KYC infrastructure
SumSub Shared
- Your users are already verified via SumSub
- Share existing verification using a share token
- Requires 3-party data sharing agreement
- Best for: Partners already using SumSub
Reliance
- You perform full KYC verification on your platform
- Provide complete verified data via API
- Requires Wirex audit and approval
- Best for: Partners with established KYC processes
Verification Status
Users progress through verification statuses:
| Status | Description |
|---|---|
NotStarted | No verification data submitted |
Applied | Data submitted, awaiting review |
InReview | Verification in progress |
Approved | Verification complete, capabilities unlocked |
Rejected | Verification failed |
Capabilities and KYC
Capabilities are unlocked based on verification level. See Capabilities for the full list and their verification requirements.
| Capability | Required Level |
|---|---|
SepaAccount | SDD |
AchAccount | SDD |
VisaVirtualCard | SDD |
SepaOut3rdParty | SDD |
After KYC approval, check the user's capabilities to determine which features are available.
Updated 8 days ago
