Customer Management Overview

Customer Management

Purpose: Enhance customers with additional data and KYC verification.

Customer management allows you to add more information to customers created in the core flow. While customers can be created with empty data {} for the fastest integration, you can enhance them with personal details, contact information, and KYC verification for compliance.

Enhancement Options

Base Data Management

Update customer profile information including:

Personal Details: First name, last name
Contact Information: Email, phone number
Address: For compliance and verification

👉 Manage Base Data

KYC Verification

Handle Know Your Customer (KYC) compliance:

Identity Verification: Document upload and verification
Share Tokens: SumSub token-based verification for crypto rails
Compliance Status: Track verification progress

SumSub ShareToken Workflow

For crypto rails operations, implement this pattern:

# 1. Create customer with minimal data
POST /v1/customers {"email": "user@example.com"}
 
# 2. PATCH with shareToken (repeat as tokens expire)  
PATCH /v1/customers/{id} {"shareToken": "sumsub_token_xyz"}

👉 Manage KYC

When to Use Enhancements

Core Flow (Required for basic transfers):

✅ Empty customer creation {}
✅ Add wallets
✅ Create transfers
✅ Status updates

Enhancements (Add when needed):

📊 Base Data: When you need customer profiles, communications
🔒 KYC Verification: When compliance is required for your use case
📈 Advanced Features: When scaling beyond basic transfers

The core flow gets you started quickly. Add enhancements as your integration grows more sophisticated.