3.15【银行用户新增绑卡申请】接口


测试地址: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. 对私(银行账户名称默认为法人姓名)
  2. 对公(银行账户名称默认为企业名称)

企业性质=企业/事业单位,默认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

 

失败原因

 

maxy2 2024年12月24日 10:47 收藏文档