主题
商户账户余额查询
接口描述
- 接入方可以通过该接口查询商户账户余额。
请求URL
/merchant/accountQuery
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202409561403450909 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| merchantNo | 是 | string | 32 | 商户编号 | XS241111000102 |
| accountType | 否 | string | 32 | 账户类型： BASE-基本户; SETTLEMENT-结算账户; BANK-银行账户 | SETTLEMENT |
| accountBankCode | 否 | string | 32 | 银行编码(银行账户必填,SMBYY:苏商银行),查询对应银行账户时需确认是否已在银行侧开户 | SMBYY |
请求报文示例
json
{
"appId": "202415629590370906",
"accountType":"SETTLEMENT",
"merchantNo": "XS241111000102",
"signature": "TzEsSjE91CkFYnf7sVi5a7dl9NvkPs8Cp8UGQs0ZWM8TwWDEawdujAX99nEEeHaiiNGAcs8fP7gU5D8XfXmu1bf7Hoy9NVyc9wNguTmCppRS60d0ui63ah1Jwl11jtsKTjRUNlL3goil5NtCCwnkBBzFhsXs/3RKwWqtWg/CZsXg9SmmFD4AMAV6RGJQv19GfCDI55/gP+PL4wdvtjAmUVC+/pnfUtSDl/hyzhfXb9IH548rPMzCcVNmsNmo8qF/wQX1rXl1PR6P7qF4RnU1ThNYNRLKF+5a/vKokQsVFxown7gGCbt3R+dBS1sdurJ5KD4tYvNf2AZkEDHeNKqV3Q==",
"transDate": "1731469972412",
"transNonce": "49a21156-b449-4b68-ae56-2a2cd6feacfc"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| merchantNo | 是 | string | 32 | 商户号 | XS241111000102 |
| accountType | 是 | string | 32 | 账户类型： BASE-基本户; SETTLEMENT-结算账户; BANK-银行账户 | SETTLEMENT |
| availableBalance | 是 | number | 可用金额，单位：分 | 9999999 | |
| frozenBalance | 是 | number | 冻结金额，单位：分 | 100 |
响应示例
json
{
"accountType":"SETTLEMENT",
"availableBalance":"0",
"frozenBalance":"0",
"merchantNo": "XS241111000102",
"code":"00000000",
"message": "成功",
"signature": "TzEsSjE91CkFYnf7sVi5a7dl9NvkPs8Cp8UGQs0ZWM8TwWDEawdujAX99nEEeHaiiNGAcs8fP7gU5D8XfXmu1bf7Hoy9NVyc9wNguTmCppRS60d0ui63ah1Jwl11jtsKTjRUNlL3goil5NtCCwnkBBzFhsXs/3RKwWqtWg/CZsXg9SmmFD4AMAV6RGJQv19GfCDI55/gP+PL4wdvtjAmUVC+/pnfUtSDl/hyzhfXb9IH548rPMzCcVNmsNmo8qF/wQX1rXl1PR6P7qF4RnU1ThNYNRLKF+5a/vKokQsVFxown7gGCbt3R+dBS1sdurJ5KD4tYvNf2AZkEDHeNKqV3Q==",
"transDate": "1731469972412",
"transNonce": "49a21156-b449-4b68-ae56-2a2cd6feacfc"
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述