测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码(transCode):1060
说明:
中信银行:支持中信银行查询公共登记薄、银行子账户实时余额;返回可用余额、可提现余额;
华通银行:仅支持查询银行子账户实时余额;返回总余额、冻结金额、可用余额,总余额=冻结金额+可用余额;
新网银行:仅支持查询银行子账户实时余额;返回总余额、冻结金额、可用余额,总余额 = 可用余额+冻结余额;
可用余额=可提现金额+在途余额
冻结余额=冻结在途金额+冻结可提现金额
业务请求参数
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
是 |
请求流水号 |
|
signNum |
String |
是 |
商户会员编号 |
支持平台类账户查询,上送#yunBizUserId_B2C# |
subAcctNo |
String |
否 |
银行子账号 |
当银行账户类型=14:用户登记薄,必填 |
acctAttr |
String |
是 |
银行账户类型 |
a.中信银行,支持查询“公共登记簿标识”余额,枚举值如下: 00:公共计息收费登记薄 b.中信银行,支持查询“平台剩余透支额度标识”余额,枚举值如下: RO:平台剩余透支额度 c.针对中信银行、华通银行,支持查询“银行子账户登记簿标识”余额,枚举值如下: 14:用户登记薄 |
业务响应参数
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
respTraceNum |
String |
否 |
响应流水号 |
|
respCode |
String |
是 |
业务码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
否 |
失败原因 |
|
signNum |
String |
是 |
商户会员编号 |
|
avlBalance |
Long |
否 |
可用余额 |
单位:分 说明:中信银行、华通银行返回“可用余额” |
withdrawBalance |
Long |
否 |
可提现余额 |
单位:分 说明:中信银行返回 |
balance |
Long |
否 |
总余额 |
单位:分 说明:华通银行返回 说明:华通银行总余额=冻结金额+可用余额 |
frozenAmount |
Long |
否 |
冻结金额(不可用) |
单位:分 说明:华通银行返回 |
splsOverBalance |
Long |
否 |
平台剩余透支金额 |
单位:分 仅上送“RO_平台剩余透支额度”返回 说明:中信银行返回 |