5、余额查询接口（MerchantBalance）

5.1、MerchantBalance 接口

URL: https://${domain}/api/mch/balance

请将 ${domain} 替换为您的实际服务域名。

类型: POST

Content-Type: application/json

接口说明: 此接口用于查询商户余额。

Body 参数

参数	类型	长度	必填	说明
mchNo	string	32	是	商户编号
appId	string	32	是	应用ID
sign	string	256	是	签名
reqTime	Int	11	是	请求时间戳（秒）

请求示例

{
    "mchNo": "M1735112701",
    "appId": "676bb7fefb715596544e2210",
    "sign": "B5C3EC55B093C9DE54EBB1199D0FFE7D",
    "reqTime": "1739413509"
}

5.2、MerchantBalance 返回结果

响应格式: application/json

Response 字段

参数	类型	说明
code	Int	调用结果：0 表示成功（success），其余表示失败（error）
data	Object	包含具体的数据信息
msg	string	结果描述
sign	string	签名，用于验证数据的完整性和真实性

data 对象字段

参数	类型	说明
balanceAvailable	string	可用余额
balanceFrozen	string	冻结余额

响应示例

{
    "code": 0,
    "data": {
        "balanceAvailable": 29140100,
        "balanceFrozen": 2275300
    },
    "msg": "SUCCESS",
    "sign": "1DF59653BF8091715B88AADC9F40FF53"
}

TIP

•接收到响应后，请务必验证 sign 字段，确保数据未被篡改。

•根据 state 的值判断当前订单的支付状态，并进行相应的业务逻辑处理。

•使用 HTTPS 协议，确保数据传输安全。