文档目录 · 余额查询

余额查询

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 表示支付成功,延迟资金仍可能处于待到账;到账时间以订单成功时间为锚点。请通过余额查询区分可用与待到账金额。

搜索文档