Wallet Balance

The Wallet Balance endpoint allows merchants to programmatically retrieve the real-time balance of their Servinux account. V2 uses **Intelligent Header Resolution**, automatically mapping the balance to the merchant associated with the provided Secret Key.

Endpoint Details

Base URL https://merchant.servinux.com/v2/get_balance
Method GET
Auth Authorization: Bearer

Implementation Example (V2)

cURL Request
curl --request GET \
  --url 'https://merchant.servinux.com/v2/get_balance' \
  --header 'Authorization: Bearer sk_live_your_secret_key' \
  --header 'Content-Type: application/json'

Success Response

{
  "success": true,
  "data": {
    "business_name": "9jaBillz Technologies",
    "merchant_code": "FP941CD9A8DB9D",
    "balance": 154200.50,
    "currency": "NGN"
  }
}
business_name String

The legal name of your entity as verified during KYC.

merchant_code String

Your public-facing merchant identifier.

balance Float

The total settleable funds currently available in your wallet.