Balance API
Retrieve your balance information with the Balance API
Balance API is Kora’s product for receiving real-time Balance information. This real-time Balance data can be helpful, for example, when checking to see if your account has sufficient funds before using it as a funding source for a payout. With the Balance API, you can easily access your balance without having to log into your dashboard. It also provides you with the liberty and flexibility to incorporate your Korapay Balance into your application however you deem fit.
Balance Request
This endpoint returns your Korapay balances (available and pending) and requires secret key authentication.
{{baseurl}}/merchant/api/v1/balances
The Balance API automatically returns both the available and pending balances across all supported currencies in the response. By default, balances are provided for NGN, but merchants with multi-currency accounts will also receive balances for other supported currencies, including USD, GHS, KES, XAF, XOF and ZAR.
Here's a sample response:
{
"status": true,
"message": "success",
"data": {
“NGN”: {
“pending_balance” : 100000.78,
“available_balance” : 400300.90
}
}
}
Updated 20 days ago