Account Management
Check Balance
Retrieve your current wallet balance.
This endpoint requires an API key with the profile scope. Services-scoped keys will receive a 403 Forbidden.
All API requests must be made over HTTPS to: https://kda-turbo-web.vercel.app
Endpoint
Example
curl -X GET https://kda-turbo-web.vercel.app/api/services/balance \
-H "Authorization: Bearer kds_test_YOUR_API_KEY"const res = await fetch("https://kda-turbo-web.vercel.app/api/services/balance", {
headers: { "Authorization": "Bearer kds_test_YOUR_API_KEY" }
});
const { data: { balance } } = await res.json();
console.log(`Wallet balance: ₦${balance}`);import requests
response = requests.get(
"https://kda-turbo-web.vercel.app/api/services/balance",
headers={
"Authorization": "Bearer kds_test_YOUR_API_KEY",
},
)
data = response.json()<?php
$ch = curl_init("https://kda-turbo-web.vercel.app/api/services/balance");
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => [
"Authorization: Bearer kds_test_YOUR_API_KEY",
],
CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);Response
{
"success": true,
"data": {
"mode": "sandbox",
"balance": 95000
}
}Prop
Type
Best Practices & Next Steps
Wallet Balance Monitoring: Before submitting high-volume purchase requests, check your wallet balance to ensure sufficient funds. If a purchase attempt exceeds your available balance, the API returns a 400 Bad Request with an INSUFFICIENT_FUNDS error code.