Get Account Balance

POST https://sandbox.temboplus.com/account/balance

This endpoint allows merchants to check the current balance of a specific virtual account. It provides both available and booked balances along with account details, allowing merchants to monitor their collection funds.

Headers

Name	Type	Description
Content-Type	string	Must be set to application/json for all requests
Authorization*	string	Authentication token in the format: Bearer <token>
x-request-id*	string	A UUID that uniquely identifies each request

Request Body

Name	Type	Description
accountNo*	string	The merchant virtual account number

200 Success

{
  "success": true,
  "message": "Success",
  "result": {
    "accountNo": "015A8XX787600",
    "accountName": "TEMBOPLUS COMPANY LIMITED",
    "branchCode": "00003385",
    "availableBalance": 2565138973.78,
    "bookedBalance": 2565138973.78
  }
}

400 Bad Request Validation error

{
  "statusCode": 400,
  "message": "Validation failed",
  "error": "Validation Error",
  "details": {
    "accountNo": "\"accountNo\" is required"
  }
}

404 Not Found

No response body is returned for 404 errors when the account is not found.

Curl

curl --request POST \
  --url https://sandbox.temboplus.com/account/balance \
  --header 'content-type: application/json' \
  --header 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  --header 'x-request-id: 550e8400-e29b-41d4-a716-446655440000' \
  --data '{
     "accountNo": "015A8XX787600"
  }'