查询余额

POST /v1/api/tenant/query_balance

• data 是对象，不是账户列表。不要用总余额减冻结后再次重复扣减冻结。

请求参数

字段	类型	要求	说明
tenant_id	string	必填	商户编号，须与 app_key 属于同一商户；最多 20 字符。
app_key	string	必填	商户应用标识，最多 16 字符；使用该应用对应的 app_secret 签名。
timestamp	string / integer	必填	当前 Unix 秒级时间戳。超过 60 秒的旧时间戳会被拒绝；不要传毫秒。
sign	string	必填	按签名规则计算的 32 位小写 MD5。

签名计算见签名规则。

请求示例 · cURL

curl --request POST 'https://api.trpay2024.com/v1/api/tenant/query_balance' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tenant_id": "DEMO0001",
  "app_key": "demo_app_key",
  "timestamp": "1791199800",
  "sign": "4ec5f59fa281ba9a12439f3adbb29fca"
}'

响应示例

{
  "request_id": "00000000-0000-4000-8000-000000000001",
  "path": "/v1/api/tenant/query_balance",
  "success": true,
  "code": 200,
  "message": "成功",
  "data": {
    "merchantCode": "DEMO0001",
    "balance": 10000,
    "totalBalance": 10521,
    "creditBalance": 0,
    "freezeBalance": 521,
    "usableBalance": 10000
  }
}

data 字段

字段	类型	要求	说明
merchantCode	string	必填	商户编号。
balance	number	必填	账面可用余额。
totalBalance	number	必填	可用余额 + 冻结余额。
creditBalance	number	必填	信用额度。
freezeBalance	number	必填	冻结余额。
usableBalance	number	必填	可用余额 + 信用额度。

异常处理

请参阅HTTP 处理、请求异常处理和错误码。