AfroPin Developers
Postman Sign in Get test keys

Your balances

Get the balance of each currency wallet on your account. Issuing and topping up PINs is paid from these balances.

GET https://afropin.com/api/v1/reseller/wallets

HMAC-signed request with a unique Idempotency-Key header. Authentication

With an SDK
PHP$afropin->reseller->wallets->list($params)
Node.jsafropin.reseller.wallets.list(params)
Pythonafropin.reseller.wallets.list(params)
Javaafropin.reseller().wallets().list(params)

This endpoint takes no parameters. It returns one entry per currency wallet in the mode of your API key, sorted by currency code.

Response fields

amount
Available balance as a number, truncated (never rounded up) to 2 decimal places.
currency
ISO 4217 currency code of the wallet, for example NGN.
Test and live balances are separate. Test balances are funded from the dashboard and never move real money. Environments

Request

GET /api/v1/reseller/wallets

Response 200

{
    "ok": true,
    "data": [
        {
            "amount": 1250000.5,
            "currency": "NGN"
        },
        {
            "amount": 840.25,
            "currency": "NGN"
        }
    ]
}

Errors

Failed requests return a stable code with a translated message. Branch on code, never on the message.

{
    "ok": false,
    "error": {
        "code": "invalid_api_key",
        "message": "This API key is unknown, revoked or expired, or live access is not switched on",
        "fields": null
    }
}
All error codes →