2.4【个人会员实名及绑卡(申请)】


测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle

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

接口代码(transCode):1010

功能说明:

支持通过此接口完成会员注册、实名及绑卡,即可开通薄记账户;

(1)个人会员仅上送实名信息:

-身份证证件类型:姓名+身份证件号:统一认证身份证认证渠道,认证通过,完成实名。

-非身份证类型,接口响应:“不支持此证件类型”。可通过运营流程线下人工添加实名。

(2)个人会员上送实名信息及银行卡信息:

-身份证证件类型:姓名+身份证号+银行卡号+预留手机号:统一认证银行卡四要素认证渠道/收银宝/收付通支持的证件类型,认证通过,完成实名及绑卡;

-其他证件类型:姓名+身份证号+证件类型(收银宝/收付通支持的证件类型)+银行卡号+预留手机号:收银宝/通联通快捷签约完成认证,签约通过,完成实名及绑卡;若绑卡方式=8-统一认证四要素,则接口提示错误“非大陆身份证不支持绑卡方式8-银行卡四要素认证!”

  1. 针对已实名认证的个人会员,支持通过此接口补充绑定银行卡,银行卡户名需与已实名信息一致
  2. 个人会员签约绑卡(绑卡方式=6/7)成功,若会员未绑定过手机号,则将银行卡预留手机号作为绑定个人手机号,后续无需通过【会员绑定手机号申请】接口完成绑定手机号。

处理逻辑:

(1)已实名个人会员进行再次实名,则提示“会员已实名!”

(2)个人会员:未实名,支持实名+绑定同名卡。

(3)个人会员:已实名,支持新增绑定同名卡,可支持绑定多张卡。

(3)企业会员(个体工商户):已实名,请求绑法人卡,仅支持绑定一张法人卡。

 

测试参数说明:

 收付通绑卡(绑卡方式6)规则:
卡号0、1、9结尾模拟为成功
卡号2结尾模拟为无效卡号
卡号3结尾模拟为已挂失卡
卡号4结尾模拟为余额不足
卡号5结尾模拟为无此账户
卡号6结尾模拟为无此原交易
卡号7结尾模拟为户名错
卡号8结尾模拟为交易超时
         
 测试环境统一验证(绑卡方式8)结果模拟规则如下:
卡号第四位为0,交易成功(可以使用:621026开头,19位卡号的卡)
卡号第四位为1,查开户方原因
卡号第四位为2,无效卡号
卡号第四位为3,已挂失卡
卡号第四位为4,余额不足
卡号第四位为5,无此账户
卡号第四位为6,原交易失败,不收费
卡号第四位为7,户名错
卡号第四位为8,交易超时
         

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

请求流水号

 

signNum

String

60

商户会员编号

 

memberRole

String

60

会员角色

(1)未注册时必须上送角色

(2)已注册时,无需上送   

说明:会员角色枚举值详见【接入指引-联调测试】模块。立即查看

name

String

32

姓名

说明:

企业法人名称、个人姓名

cerType

String

2

证件类型

见枚举值,支持多种证件类型

注:绑卡方式8仅支持身份证

cerNum

String

32

证件号码

SM4加密

SM4加密

acctNum

String

32

银行卡号

SM4加密

详细

若绑卡,则银行卡四要素信息字段必须均上送。

phone

String

11

银行预留手机

bindType

String

1

绑卡方式

6-通联通协议支付签约/7-收银宝快捷支付签约/8-银行卡四要素验证

说明:非大陆身份证仅支持绑卡方式6和7。

validDate

String

4

有效期,格式为月年;如0321,2位月2位年

说明:针对信用卡,若商户送,则透传渠道

cvv2

String

3

CVV2,3位数字

说明:针对信用卡,若商户送,则透传渠道

业务响应参数

字段

字段类型

字段长度

必填

字段名称

说明

respTraceNum

String

40

响应流水号

业务正常处理,则返回

signNum

String

60

商户会员编号

 

respCode

String

5

业务返回码

00000:代表成功

66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。

66668:针对绑卡方式:bindType=8的场景,银行卡绑定成功但手机号未绑定的情况下返回。

其他返回码:均代表失败

respMsg

String

200

业务返回说明

 

maxy2 2025年3月27日 11:51 收藏文档