商户余额查询 (Query Merchant Balance)

接口描述

商户调用此接口查询当前商户账户在平台上的各项资金余额（可用余额、冻结余额、在途资金等）。

---

请求信息

• 请求 URL：/payout/balance
• 请求方式：POST
• Content-Type：application/json; charset=utf-8

---

请求头（HTTP Headers）

参数名	必选	类型	说明
merchantNo	是	String	商户号
sign	是	String	请求 Body 的 RSA 签名

---

请求 Body 参数

参数名	必选	类型	示例值	说明
timestamp	是	Long	1772880600000	毫秒级时间戳

请求示例

{
  "timestamp": 1772880600000
}

---

响应参数

成功返回示例

{
  "code": 1,
  "msg": "ok",
  "data": {
    "merchantNo": "M1652264659533",
    "availableBalance": "971.40",
    "frozenBalance": "0.00",
    "unavailableBalance": "100.00"
  }
}

失败返回示例

{
  "code": 0,
  "msg": "invalid merchant"
}

返回参数说明

参数名	类型	说明
code	Integer / String	状态码：1 成功，0 失败
msg	String	消息说明
data	Object	账户资金数据对象
data.merchantNo	String	商户号
data.availableBalance	String	可用余额（可直接用于出款或提现的资金）
data.frozenBalance	String	冻结中余额（因风控、争议或保证金冻结的资金）
data.unavailableBalance	String	在途余额（银行处理中或尚未清算入账的资金）