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
    }
  }
}