Request
Less than 1 minute
HTTP Request
| Service Code | 11 |
|---|---|
| Name | API balance inquiry |
| Version | 2.0 |
| HTTP Method | POST |
| Path | {Base URL}/v2.0/inquiry-balance |
Header Parameters
| Area | Field | Attribute | Type | Description |
|---|---|---|---|---|
| Header | Content-Type | M | String | application/json |
| X-TIMESTAMP | M | String | yyyy-MM-ddTHH:mm:ss[zoneOffset] eg: 2020-12-17T10:55:00+07:00 | |
| X-SIGNATURE | M | String | Signature | |
| X-PARTNER-ID | M | String | Your merchantID |
accountNo
- Sandbox: any non-empty string (≤128). You can reuse the sample value in the example body.
- Production: Merchant Portal → Finance → Balance (separate Pay-in / Pay-out per currency). See How to get production accountNo.
Tips
Pay-in holds collected funds; pay-out is the balance available for disbursement. You can transfer between them in the portal.
Example Header – Balance Inquiry Request:
POST {Base URL}/v2.0/inquiry-balance HTTP/1.2
Content-type: application/json
X-TIMESTAMP: 2020-12-18T15:06:00+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
X-PARTNER-ID: 20001
{
"accountNo": "21220030202403071031",
"balanceTypes": [
"BALANCE"
]
}