账户余额查询

账户余额查询接口用于查询商户账户的当前可用余额、冻结余额等信息。

接口信息

• 接口地址：

/zro/account/balance-query

• 请求方式：POST
• Content-Type：application/json

请求参数

公共参数

参数名	类型	必填	描述
merchantNo	String	是	商户号
sign	String	是	签名

请求示例

{
  "merchantNo": "1082372921",
  "sign": "A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6"
}

响应参数

成功响应

参数名	类型	描述
code	Number	响应码，6000 表示成功
message	String	响应信息
result	Object	余额信息

余额信息（result）

参数名	类型	描述
divideAccount	Number	分账账户余额，单位：元
fundAccount	Number	资金账户余额，单位：元
settleAccount	Number	结算账户余额，单位：元

响应示例

{
  "code": 6000,
  "message": "查询成功",
  "result": {
    "divideAccount": 0,
    "fundAccount": 0,
    "settleAccount": 28057.13
  },
  "request_id": "2425c543-e5e1-4d64-aab8-796b351f37d3",
  "timestamp": "2025-12-25 15:12:20"
}

代码示例

Java 示例

BalanceResponse response = client.queryBalance();
if (response.getCode() == 6000) {
    System.out.println("分账账户余额：" + response.getResult().getDivideAccount() + " 元");
    System.out.println("结算账户余额：" + response.getResult().getSettleAccount() + " 元");
}

PHP 示例

$response = $client->queryBalance();
if ($response['code'] === 6000) {
    $result = $response['result'];
    echo "分账账户余额：{$result['divideAccount']} 元\n";
    echo "资金账户余额：{$result['fundAccount']} 元\n";
    echo "结算账户余额：{$result['settleAccount']} 元\n";
}

余额类型说明

• 分账账户：用于分账的资金账户
• 资金账户：商户资金账户
• 结算账户：待结算到银行卡的资金

相关接口

• 待结算查询 - 查询待结算明细