余额查询
POST /api/v1/balance/query
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
currency |
string | 否 | 币种代码;省略时返回当前商户可查询的全部币种余额 |
请求示例:
{
"api_key": "<API_KEY>",
"merchant_id": "merchant_1001",
"currency": "MYR",
"timestamp": "1789516800",
"nonce": "73a2ebbf-eac5-4eab-a5fc-9dac7f2bb33d",
"sign": "<64位小写HMAC-SHA256>"
}
响应示例:
{
"code": 0,
"message": "OK",
"data": {
"balances": [
{
"currency": "MYR",
"available_amount": "1000.00",
"frozen_amount": "51.00",
"pending_settlement_amount": "0.00"
}
]
},
"request_id": "req_01JEXAMPLE"
}
available_amount 为已到账可用余额,frozen_amount 为冻结余额,pending_settlement_amount 为代收待到账净额;均为十进制字符串。待到账总额包含等待释放、释放处理中及重试耗尽后仍未到账的资金;已到账或已取消的资金不再计入。
到账规则由平台按商户通道配置,商户请求不能临时覆盖。订单查询或验签后的 Notify 显示 paid 表示支付成功,延迟资金仍可能处于待到账;到账时间以订单成功时间为锚点。请通过余额查询区分可用与待到账金额。