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


测试地址:https://ibstest.allinpay.com/yst/yst-service-api/tm/handle

生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle

接口代码(transCode):1028

说明:支持开通银行子账户的会员在银行侧新增绑卡;

华通银行:

(1)个人会员绑定对私银行卡:针对姓名、证件号、银行卡号、银行预留手机号个人四要素鉴权,四要素鉴权认证通过后绑卡,用于后续提现。

(2) 企业会员绑定对公账户:对于不需要对公打款验证的客户,系统默认直接绑定成功(注:向银行申请对公打款金额免验证)。

(3)针对个体工商户:户名是经营者个人名字,则绑卡只能绑个人的对私卡。户名是企业工商名称,则绑定对公户。

中信银行:

(1)个人会员绑定对私银行卡:个人的用户绑卡时系统会对账户信息进行四要素验证(账户名称、证件号码、银行账号、银行预留手机号)。认证成功则绑卡成功,认证失败则绑卡失败。

(2)企业会员绑定对公户:银行为企业的用户绑卡时系统会触发一分钱打款校验,从平台自有资金账户打一分钱到绑定账户以校验账户有效性,实时响应绑定结果。

说明:若会员子账户开启转账入金功能,多个未注销状态用户不可绑定同一银行账户。

民生银行:

(1)个人会员绑定对私银行卡:系统会对账户信息进行四要素验证(账户名称、证件号码、银行账号、银行预留手机号)。认证成功则绑卡成功,认证失败则绑卡失败。

(2)企业会员绑定对公户:需要上送大额行号,银行侧未做账户正确性校验,若信息不正确,影响提现;

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

 

商户请求流水号

商户系统内保持唯一,定义长度为50位

signNum

String

 

商户会员编号

 

subAcctNo

String

 

银行子账号

 

bankAcctDetail

JSONObject

 

银行账户信息

详情,复用企业实名开户接口的银行账户对象

bankAcctExtInfo

JSONObject

 

银行绑卡申请(其他)信息

详情

银行账户信息(bankAcctDetail)

字段

字段类型

必填

字段名称

说明

acctAttr

String

账户类型

0:对私(银行账户名称默认为法人姓名)

1:对公(银行账户名称默认为企业名称)

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

 

失败原因

 

cardInfo

JSONObject

 

绑卡信息

民生银行,返回

详情

 

银行绑卡信息

字段

字段类型

必填

字段名称

说明

bindState

String

绑卡结果

1:已绑定

0:未绑定

2:已解绑

4:待绑定

cardNo

String

银行卡号

 

bindTime

String

绑卡时间

已绑定,则返回

格式:202411251038

 

 


maxy2 2026年2月26日 15:21 收藏文档