Check Balance

API ENVIRONMENT

Endpoint

POST

https://sandbox.ipaymu.com/api/v2/balance

Use credentials from the selected environment. Sandbox and Production credentials are separate.

Check your current iPaymu merchant balance.

string

string

Example / value: YOUR_VA
Description: Merchant Virtual Account number. Get it from the Integration menu in your iPaymu dashboard: Production / Sandbox. Use the VA for the selected environment.

string · 64 hex

Example / value: GENERATED_SIGNATURE
Description: Generate an HMAC-SHA256 signature for this request using the API Key from Production / Sandbox. Do not copy the API Key into this header. See Signature Generation.

string · 14 digits

Example / value: 20260102153045
Description: Request creation time in YYYYMMDDHHmmss format (example: 2 Jan 2026, 15:30:45). Check the endpoint guide if it specifies ISO 8601 instead.

Header	Type	Example / value	Description
`Content-Type`	`string`	`application/json`	MIME type of the JSON request body.
`va`	`string`	`YOUR_VA`	Merchant Virtual Account number. Get it from the Integration menu in your iPaymu dashboard: Production / Sandbox. Use the VA for the selected environment.
`signature`	`string` · 64 hex	`GENERATED_SIGNATURE`	Generate an HMAC-SHA256 signature for this request using the API Key from Production / Sandbox. Do not copy the API Key into this header. See Signature Generation.
`timestamp`	`string` · 14 digits	`20260102153045`	Request creation time in `YYYYMMDDHHmmss` format (example: 2 Jan 2026, 15:30:45). Check the endpoint guide if it specifies ISO 8601 instead.

Parameter	Type	Required	Description
`account`	string	Yes	Your iPaymu VA.

{
  "account": "YOUR_IPAYMU_VA"
}

{
  "Status": 200,
  "Data": {
    "Va": "YOUR_IPAYMU_VA",
    "MerchantBalance": "1500000",
    "MemberBalance": "0"
  },
  "Message": "success"
}