测试地址: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-银行卡四要素认证!”
- 针对已实名认证的个人会员,支持通过此接口补充绑定银行卡,银行卡户名需与已实名信息一致
- 个人会员签约绑卡(绑卡方式=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 |
是 |
业务返回说明 |