银行账户余额查询

报文编号 版本号
请求 BNK1-2001-001-01 1.0.0
应答 BNK1-2001-001-01 1.0.0

电子户余额查询接口文档

请求参数

余额查询 - 业务数据报文参数 (data)

字段名 参数名 类型 必填 是否加密 描述
uid 统一会员号 string(64) M 否
orderId 请求流水号 string(64) M 否 请求流水号，只能为数字、大小写字母和下划线
clientIp 客户端IP string(32) C 否
clientMac 客户端MAC地址 string(64) C 否
bankAccountNo 银行账户号 string(64) M 否

返回参数

公共报文 - 返回参数

字段名 参数名 类型 必填 描述
code 返回码 string(64) C
message 返回信息 string(32) C
success 响应状态 Boolean M true：响应成功 false：业务异常
data 返回参数 json C 见下方返回参数

余额查询 - 返回参数 (data)

字段名 参数名 类型 必填 描述
totalAmount 账户余额 Long M 单位分
frozenAmount 冻结金额 Long C 单位分
availAmount 可用余额 Long C 单位分

说明：

  1. 请求参数：
    • 嵌入了“公共报文 - 请求参数”，data 中仅包含 bankAccountNo，符合开户查询的最小需求。
    • bankAccountNo 是唯一的业务参数，用于指定查询的信息。
  2. 返回参数：
    • 嵌入了“公共报文 - 返回参数”，data 中包含具体的余额查询结果。
  3. 格式规范：
    • 字段长度和类型严格按照您提供的内容定义。

示例请求 JSON：

示例返回 JSON：

成功示例：