Get Disbursement Wallet Balance

Use this endpoint to retrieve the balance of your disbursement wallet

Endpoint

POST /wallet/main-balance

Request

Headers

• Content-Type* — Must be application/json

• x-account-id* — Your unique TemboPlus account identifier

• x-secret-key* — Your TemboPlus API secret key

• x-request-id* — Unique UUID per request for tracing

Body Parameters

This endpoint requires no request paylod.

Responses

200 OK

Returns the current and available balance along with account details such as account name, number and status.

Response Format

{
  "currentBalance": 15000, // Total balance in your disbursement wallet (TZS)
  "availableBalance": 14500, // Available balance for transactions (TZS)
  "accountName": "Your Business Name", // Your disbursement account name
  "accountNo": "900XXXXXXX", // Your disbursement account number
  "accountStatus": "ACTIVE" // Account status
}

401 UNAUTHORIZED

Returned when authentication headers are missing or invalid.

Response Format:

{
    "statusCode": 401,
    "reason": "INVALID_CREDENTIALS",
    "details": {}
}

500 INTERNAL SERVER ERROR

Indicates a temporary issue within TemboPlus. Retry later or contact TemboPlus Support with your x-request-id.

Response Format:

{
    "statusCode": 500,
    "reason": "SERVER_ERROR"
}