Ledger
Wallet & Funding API
Programmatically check balances, generate dedicated Virtual NGN Accounts, initialize card funding, execute peer transfers, and stream ledger statement history.
POST
/api/v1/wallet/virtual-account/requestRequest Dedicated Virtual Account
Generate a dedicated permanent NGN Virtual Bank Account for automated wallet top-up via any Nigerian bank transfer.
Request Headers
Header
Value
Authorization
Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type
application/json
X-Channel
api
Request Body
{
"currency": "NGN",
"provider": "wema"
}Code Execution Playground
Request Snippet (CURL)
curl -X POST "https://backend.cbivas.com/api/v1/wallet/virtual-account/request" \
-H "Authorization: Bearer cbi_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"currency":"NGN","provider":"wema"}'Success Response (200 OK)
{
"account_number": "9820391823",
"bank_name": "Wema Bank / Providus",
"account_name": "CBI-Acme Solutions",
"currency": "NGN",
"status": "active",
"expiry_date": null
}