测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址:http://116.228.64.55:28082/yst-service-api/tx/handle
接口代码(transCode):1010
功能说明:
支持通过此接口完成消费者银行卡快捷签约,用于后续银行卡支付;
- 个人会员上送实名信息及银行卡信息:
-身份证证件类型:姓名+身份证号+银行卡号+预留手机号:收银宝/收付通支持的证件类型,认证通过,完成实名及绑卡;
-其他证件类型:姓名+身份证号+证件类型(收银宝/收付通支持的证件类型)+银行卡号+预留手机号:收银宝/通联通快捷签约完成认证,签约通过,完成绑卡;
- 个人会员签约绑卡(绑卡方式=6/7)成功,若会员未绑定过手机号,则将银行卡预留手机号作为绑定个人手机号,后续无需通过【会员绑定手机号申请】接口完成绑定手机号。
业务请求参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
reqTraceNum |
String |
50 |
是 |
请求流水号 |
|
|
signNum |
String |
60 |
是 |
商户会员编号 |
|
|
memberRole |
String |
60 |
否 |
会员角色 |
固定上送:消费者 |
|
name |
String |
32 |
是 |
姓名 |
个人姓名 |
|
cerType |
String |
2 |
是 |
证件类型 |
见枚举值,支持多种证件类型 |
|
cerNum |
String |
32 |
是 |
证件号码 SM4加密 |
SM4加密。 |
|
acctNum |
String |
32 |
否 |
银行卡号 SM4加密 |
若绑卡,则银行卡四要素信息字段必须均上送。 |
|
phone |
String |
11 |
否 |
银行预留手机 |
|
|
bindType |
String |
1 |
否 |
绑卡方式
|
|
|
validDate |
String |
4 |
否 |
有效期,SM4加密 格式为月年;如0321,2位月2位年 说明:针对信用卡,若商户送,则透传渠道 |
|
|
cvv2 |
String |
3 |
否 |
CVV2 3位数字,SM4加密 说明:针对信用卡,若商户送,则透传渠道 |
业务响应参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
respTraceNum |
String |
40 |
否 |
响应流水号 |
业务正常处理,则返回 |
|
signNum |
String |
60 |
否 |
商户会员编号 |
|
|
respCode |
String |
5 |
是 |
业务返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
|
respMsg |
String |
200 |
是 |
业务返回说明 |