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.
POST
/api/v1/auth/loginUser & Application Login
Obtain JWT access and refresh tokens for dashboard and API automation.
Request Headers
Header
Value
Authorization
Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type
application/json
X-Channel
api
Request Body
{
"email": "developer@company.ng",
"password": "YourStrongPassword@123"
}Code Execution Playground
Request Snippet (CURL)
curl -X POST "https://backend.cbivas.com/api/v1/auth/login" \
-H "Content-Type: application/json" \
-d '{"email":"developer@company.ng","password":"YourStrongPassword@123"}'Success Response (200 OK)
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "Bearer",
"expires_in": 86400,
"user": {
"id": "c1cd3304-3d71-4fc3-8bfe-5e11e0cbb9b6",
"email": "developer@company.ng",
"full_name": "Lead Engineer"
}
}