查询接口
查询接口
三个只读接口让对账不依赖回调:账户余额、收款订单状态、代付订单状态。
最后更新 2026-10-24
余额查询
三个余额概念:可用、代付在途冻结、投诉冻结。
POST /api/payuser/getBalance
sign = md5(merchantNo + key)
{ "code": 1, "data": {
"balance": 99500.00,
"frozen_balance": 0.00,
"other_frozen_balance": 0.00
}}代收订单状态
callback_status 告诉你通知本身有没有投递成功 —— 你的接口挂过时特别有用。
| 字段 | 含义 |
|---|---|
| status | 1 待支付,2 已支付,3 失败 |
| actual_amount | 实际支付金额 |
| utr | 银行流水号 |
| callback_status | 0 未回调,1 成功,2 失败 |
代付订单状态
error_msg 带失败或冲正原因;status 3 和 4 同时意味着余额已退回。
POST /api/orderquery/payoutStatus
sign = md5(user_id + merchant_order_no + key)
{ "code": 1, "data": {
"status": 2,
"fee": 36.00,
"utr": "333678793673",
"callback_status": 1,
"success_time": "2026-10-24 09:30:00"
}}