Get Collection Wallet Balance

Use this endpoint to retrieve the balance of your collection wallet.

Endpoint

POST /wallet/collection-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 collection wallet (TZS)
  "availableBalance": 14500, // Available balance for transactions (TZS)
  "accountName": "Your Business Name - Collection", // Your collection account name
  "accountNo": "900XXXXXXX", // Your collection 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"
}