Quickstart
Getting Started & Auth
Connect to the CBI Digital VAS API using REST over HTTPS. Authenticate requests using your API Key or JWT Bearer token in the Authorization header.
Architecture & Integration Guidelines:
- Base Production URL: https://backend.cbivas.com/api/v1
- All requests and responses use standard JSON (application/json).
- Authentication: Authorization: Bearer cbi_live_... or JWT access token.
- Idempotency: Pass idempotency_key in request payloads to safely retry payments without duplicate charges.
GET
/api/v1/auth/meVerify Credentials & Get Profile
Validate your Bearer token or API key and fetch active user account, company context, wallet balance, and permissions.
Request Headers
Header
Value
Authorization
Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type
application/json
X-Channel
api
Code Execution Playground
Request Snippet (CURL)
curl -X GET "https://backend.cbivas.com/api/v1/auth/me" \ -H "Authorization: Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json"
Success Response (200 OK)
{
"id": "c1cd3304-3d71-4fc3-8bfe-5e11e0cbb9b6",
"email": "developer@company.ng",
"full_name": "Lead Engineer",
"account_type": "corporate",
"company": {
"id": "comp_91823abf",
"name": "Acme Fintech Solutions Ltd",
"rc_number": "RC-1928341",
"status": "approved"
},
"wallet_balance": "93300.01",
"currency": "NGN",
"has_transaction_pin": true,
"status": "active"
}