测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码(transCode):1010
功能说明:
支持通过此接口完成会员注册、实名及绑卡,即可开通待结算户;
(1)个人会员仅上送实名信息:
-身份证证件类型:姓名+身份证件号:统一认证身份证认证渠道,认证通过,完成实名。
-非身份证类型,接口响应:“不支持此证件类型”。可通过运营流程线下人工添加实名。
(2)个人会员上送实名信息及银行卡信息:
-身份证证件类型:姓名+身份证号+银行卡号+预留手机号:统一认证银行卡四要素认证渠道认证通过,完成实名及绑卡;
-
- 针对已实名认证的个人会员,支持通过此接口补充绑定银行卡,银行卡户名需与已实名信息一致。
处理逻辑:
(1)已实名个人会员进行再次实名,则提示“会员已实名!”
(2)个人会员:未实名,支持实名+绑定同名卡。
(3)个人会员:已实名,支持新增绑定同名卡,可支持绑定多张卡。
(3)企业会员(个体工商户):已实名,请求绑法人卡,仅支持绑定一张法人卡。
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
50 |
是 |
请求流水号 |
|
signNum |
String |
60 |
是 |
商户会员编号 |
|
memberRole |
String |
60 |
否 |
会员角色 |
|
name |
String |
32 |
是 |
姓名 |
说明: 企业法人名称、个人姓名 |
cerType |
String |
2 |
是 |
证件类型 |
见枚举值,支持多种证件类型 注:绑卡方式8仅支持身份证 |
cerNum |
String |
32 |
是 |
证件号码 SM4加密 |
SM4加密。 |
acctNum |
String |
32 |
否 |
银行卡号 SM4加密 |
若绑卡,则银行卡四要素信息字段必须均上送。 |
phone |
String |
11 |
否 |
银行预留手机 |
|
bindType |
String |
1 |
否 |
绑卡方式 8-银行卡四要素验证 |
|
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 |
是 |
业务返回说明 |