Skip to main content

Billing

Overview​

Billing endpoints expose billing-related information for the authenticated partner.

Authentication and access control​

All Public API billing endpoints require an OAuth2 bearer token:

  • Authorization: Bearer <your_api_key>

Important: External partners can only access their own data. If you attempt to query another partner’s data, the API will return 403 Forbidden.

Get Available Balance​

What it does​

Returns your available balance, calculated as the sum of transaction amounts (Debit & Credit).

This is commonly used to display a “current available balance” and to check whether you have enough balance before starting work.

Endpoint​

GET /api/v1/billing/balance

Example request​

curl -X GET "https://sandboxapi.efica.co.za/api/v1/billing/balance" \
  -H "Authorization: Bearer <your_api_key>"

Example response (200)​

{
  "balance": 1234.56
}

Common error responses​

  • 401 Unauthorized: Missing or invalid API key / token.

Document history​

VersionDateNotes
1.02026-06-01Initial release

Support​

For technical support and questions:

This documentation is maintained by the eFICA development team. For updates and corrections, please contact your account manager.

Last Updated: 1 June 2026