NeroPay Docs
API & Integrations

Balances API

Balances

Balances API

Use balances to show available funds before payouts and to reconcile wallet activity.

WalletsAvailable fundsNeroConnect

Balance endpoint

GET/balances

Returns wallet balances and payment availability for the authenticated merchant or selected connected account.

For platforms, send NeroPay-Account to retrieve balances for a connected merchant. Without it, the platform merchant balance is returned.

 true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $secretKey,
        'Accept: application/json',
        'NeroPay-Account: ' . $connectedAccount,
    ],
]);
echo curl_exec($ch);
curl_close($ch);
{
  "success": true,
  "data": {
    "account_id": "NP6454f52b_6165",
    "currency": "GBP",
    "available_funds": "72.31",
    "pending_funds": "15.99",
    "wallets": [
      {
        "currency": "GBP",
        "available": "72.31",
        "pending": "15.99"
      }
    ],
    "nerocard": {
      "available": "25.00",
      "currency": "GBP"
    },
    "issuing": {
      "available": "10.00",
      "currency": "GBP"
    }
  }
}

Parameters

This endpoint has no body parameters. Use query parameters such as ?currency=GBP only when your implementation supports currency filtering.

Errors

{
  "success": false,
  "error": {
    "code": "account_not_found",
    "message": "The selected connected account could not be found.",
    "details": null
  }
}