# 4、Querying Balance

Request Method:

  • GET

Request URL:

/api/v3/vn/query/balance

Request Headers:

Content-Type: application/json;charset=utf-8

Request Header Parameters:

Param Description Example
access_key Merchant backend key pFqV75X3
timestamp Unix timestamp (13 digits, milliseconds) 1679724896223
nonce UUID V4 794c26b0-d33c-4394-b2bb-c485eca16d9e
sign Signature string kAXyh+eerqrefyaF8dyFB0M4FVo=

Response Example:

{
    "code": "200",
    "success": true,
    "msg": "成功",
    "msgEn": "SUCCESS",
    "data": [
        {
            "accountBalance": "0",
            "accountFreezeAmount": "0",
            "accountStatusId": 4,
            "accountWaitSettledAmount": "0",
            "currencyType": "VND",
            "accountStatus": "InAndOut"
        }
    ]
}

Response Parameter Descriptions:

Param Type Description
accountBalance String Available account balance
accountFreezeAmount String Account frozen amount
accountStatusId int64 Account status ID (Enum values: 1, 2, 3, 4)
accountWaitSettledAmount String Account unsettled amount
currencyType String Currency type
accountStatus String Account status (Enum values: "InAndOut")