3.13【银行子账户实时余额查询】接口


测试地址: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:公共计息收费登记薄
     12:自有资金登记薄
     13:担保登记薄
     17:待结算手续费登记簿

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_平台剩余透支额度”返回

说明:中信银行返回


maxy2 2025年2月28日 10:53 收藏文档