Balances

GET /mobile-money/balances returns one balance for each of your services, in each country and currency open to you. A balance is "0.00" until you collect there.

curl "https://api.kemypay.com/v1/mobile-money/balances?service=SERVICE_CODE&country=COD" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

[
  { "service_code": "019a8f2e-4c1b-7d3a-9e55-2b6f0c1d8a47", "service_name": "Afroyamo", "country": "COD", "name": "Congo - Kinshasa", "currency": "CDF", "available": "0.00", "updated_at": null },
  { "service_code": "019a8f2e-4c1b-7d3a-9e55-2b6f0c1d8a47", "service_name": "Afroyamo", "country": "COD", "name": "Congo - Kinshasa", "currency": "USD", "available": "125000.00", "updated_at": "2026-10-29T10:05:00+00:00" }
]

Rules

Each service has its own balances. Your apps never share money.
Money stays in its country. A payment collected in Cameroon credits the Cameroon XAF balance of the service, which only pays out to Cameroonian numbers. XAF from Cameroon does not pay out in Gabon, even though both use XAF.
Congo - Kinshasa has two balances, CDF and USD.
A successful payment credits net_amount (after the fee) — see Who pays the fee.
Test keys return test balances, separate from live balances.

Payouts to mobile money numbers are coming soon.

Get started

Guides

Rules

​Rules

Rules