测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码(transCode):1028
说明:支持中信银行、华通银行在个人、企业会员开通银行子账户成功后新增绑定银行账户,云商通【银行卡管理】菜单不保存绑卡信息。
华通银行:
(1)个人会员绑定对私银行卡:针对姓名、证件号、银行卡号、银行预留手机号个人四要素鉴权,四要素鉴权认证通过后绑卡,用于后续提现。
(2) 企业会员绑定对公账户:对于不需要对公打款验证的客户,系统默认直接绑定成功(注:向银行申请对公打款金额免验证)。
(3)针对个体工商户:户名是经营者个人名字,则绑卡只能绑个人的对私卡。户名是企业工商名称,则绑定对公户。
中信银行:
(1)个人会员绑定对私银行卡:个人的用户绑卡时系统会对账户信息进行四要素验证(账户名称、证件号码、银行账号、银行预留手机号)。认证成功则绑卡成功,认证失败则绑卡失败。
(2)企业会员绑定对公户:银行为企业的用户绑卡时系统会触发一分钱打款校验,从平台自有资金账户打一分钱到绑定账户以校验账户有效性,实时响应绑定结果。
说明:若会员子账户开启转账入金功能,多个未注销状态用户不可绑定同一银行账户。
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
是 |
商户请求流水号 |
商户系统内保持唯一,定义长度为50位 |
|
signNum |
String |
是 |
商户会员编号 |
||
subAcctNo |
String |
是 |
银行子账号 |
||
bankAcctDetail |
JSONObject |
是 |
银行账户信息 |
详情,复用企业实名开户接口的银行账户对象 |
|
bankAcctExtInfo |
JSONObject |
否 |
银行绑卡申请(其他)信息 |
说明:仅中信银行上送 |
银行账户信息(bankAcctExtInfo)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
acctAttr |
String |
否 |
账户类型 |
企业性质=企业/事业单位,默认1-对公,不支持上送0-对私; 企业性质=个体工商户,支持上送0-对私/1-对公,不填默认1-对公; |
acctNum |
String |
是 |
账号 |
账户类型=1-对公,企业对公账户,支持数字和“-”字符 账户类型=0-对私,则上送对私账户(借记卡) SM4加密,详细 |
bankReservePhone |
String |
否 |
银行预留手机 |
账户类型=0-对私,则必填 |
openBankNo |
String |
否 |
银行代码 |
对公:根据基础数据,上送“银行代码”字段,必填 对私:无需上送,系统自动根据卡BIN识别银行。 |
openBankBranchName |
String |
否 |
开户行支行名称 |
如:“中国工商银行股份有限公司北京樱桃园支行” 账户类型=1-对公,则必填 |
payBankNumber |
String |
否 |
支付行号,12位数字 |
账户类型=1-对公,则必填 |
openBankProvince |
String |
是 |
开户行所在省 |
开户行所在省 开户行所在市必须同时上送 根据中国省市表的“省份”内容填写。 |
openBankCity |
String |
是 |
开户行所在市 |
开户行所在市 开户行所在省必须同时上送 根据中国省市表的“城市”内容填写。 |
业务响应参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
respTraceNum |
String |
否 |
响应流水号 |
业务正常处理,则返回 |
|
respCode |
String |
是 |
业务返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
|
respMsg |
String |
是 |
失败原因 |