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

(3)此接口针对中信绑卡成功,则【银行卡管理】菜单保存数据;

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

民生银行:

(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

 

 


2026年6月29日 10:18 收藏文档