The Customers & Identity API helps businesses and platforms using Tsara manage customer records and verify their identities securely.
It supports both individuals and businesses, and integrates seamlessly into your payment, wallet, and compliance flows.
Tsara’s goal is to make identity verification simple, compliant, and developer-friendly — whether you’re onboarding users for payments, wallets, or stablecoin transfers.
🚀 Overview
With the Customers & Identity APIs, you can:
- Create Customers — Store verified profiles for individuals or businesses.
- Verify Identity — Validate BVN, NIN, or CAC details for compliance.
- Link Customers — Associate customers with wallets or bank accounts.
- Track KYC Status — Know which users are verified before enabling key operations.
🧩 Customer Types
| Type | Description | Key Attributes |
|---|---|---|
| Individual | A natural person using Tsara via your platform. | Name, Email, BVN/NIN, Phone |
| Business | A registered company using your product. | Business Name, CAC Number, Tax ID |
💡 Both customer types can be created under your business via the same unified endpoint.
🔐 Supported Identity Verification Methods
| Verification Type | Identifier | Country | Description |
|---|---|---|---|
| BVN | Bank Verification Number | 🇳🇬 Nigeria | Standard identity verification for individuals. |
| NIN | National Identification Number | 🇳🇬 Nigeria | Government-issued identity number for individuals. |
| CAC | Corporate Affairs Commission | 🇳🇬 Nigeria | Used for verifying registered businesses. |
🏦 Typical Flow
1️⃣ Create a Customer → POST /customers
2️⃣ Verify Identity → POST /customers/{id}/verify (using BVN/NIN/CAC)
3️⃣ Link Accounts → Associate with bank or wallet
4️⃣ Use for Transactions → Payments, offramps, or settlements
5️⃣ Webhook Event → Receive updates on verification success or failure
🧾 Example Customer Object
{
"id": "cus_001",
"type": "individual",
"first_name": "John",
"last_name": "Doe",
"email": "[email protected]",
"phone": "+2348012345678",
"bvn": "22334455667",
"status": "verified",
"created_at": "2025-10-17T12:00:00Z"
}⚙️ Environment Base URLs
| Environment | Base URL | Description |
|---|---|---|
| Production | https://api.tsara.ng/v1 | Live identity verification and customer data. |
| Sandbox | https://sandbox.tsara.ng/v1 | Safe testing environment for KYC and onboarding. |
💡 In sandbox mode, Tsara uses mock KYC responses for easier integration.
🧠 Best For
- Fintechs and payment platforms needing verified customers.
- Marketplaces handling settlements to users or vendors.
- Businesses building compliance-ready onboarding flows.
- Platforms linking wallets and fiat accounts to real identities.
🔗 Related Pages
- Create Customer — Add a new individual or business.
- Verify Identity — Validate BVN, NIN, or CAC.
- Webhook Events — Get updates on verification status.
- Bank Accounts — Link verified customers to NGN accounts.