测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码(transCode):1030
功能说明:
- 个人会员注册或实名成功(即会员状态=待生效/有效),则可以申请绑定手机号,申请成功,发送短信验证码。
- 企业会员实名成功(即会员状态=有效),才可以申请绑定手机号。
- 可通过【查询会员信息】接口查询会员已绑定的手机号。
- 后续会员签约签约发到此手机进行签约验证。
- 验证码有效期3分钟;
会员类型 |
绑定手机类型 |
前置条件 |
验证方式 |
发送短信验证码 |
处理说明 |
个人会员 |
/ |
注册成功或实名成功(会员状态=待生效/有效) |
短信验证 |
发送短信 |
短信验证通过,则绑定手机成功 |
短信验证不通过,则绑定手机失败 |
|||||
企业会员 |
法人手机号 |
会员实名成功(会员状态=有效) |
运营商三要素验证+短信验证 |
运营商三要素验证通过,则发送短信验证码 |
短信验证通过,则绑定手机成功 |
短信验证不通过,则绑定手机失败 |
|||||
企业授权手机号 |
法人(人脸识别)签订授权委托书 |
/ |
授权协议签约成功,则绑定手机成功 |
||
授权协议签约失败,则绑定手机失败,需要重新发起。 |
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
50 |
是 |
请求流水号 |
|
signNum |
String |
60 |
是 |
商户会员编号 |
|
phone |
String |
11 |
是 |
绑定手机号 |
|
phoneType |
String |
1 |
否 |
绑定手机类型 |
1-法人手机号 2-企业授权手机号 注:企业会员绑定手机号,必填 |
jumpUrl |
String |
256 |
否 |
前端跳转地址 |
仅上送2-企业授权手机号,可上送此字段 |
notifyUrl |
String |
256 |
否 |
签约结果通知地址 |
|
authPerInfo |
JSONObject |
否 |
被授权人信息 |
当企业会员通过(2-企业授权手机号)类型绑定手机号,必填 |
被授权人信息JSON(authPerInfo)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
authPerName |
String |
是 |
被授权人姓名 |
|
authPerCerNum |
String |
是 |
被授权人证件号 |
SM4加密 |
authPerCerType |
String |
是 |
被授权人证件类型 |
见枚举值,支持多种证件类型 |
业务响应参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
respTraceNum |
String |
40 |
否 |
响应流水号 |
业务正常处理,则返回 |
signNum |
String |
60 |
否 |
商户会员编号 |
|
respCode |
String |
5 |
是 |
业务码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
200 |
是 |
失败原因 |
|
signUrl |
String |
256 |
否 |
授权手机号签约链接(有效时间7天) |
若绑定手机类型为2-企业授权手机号时返回,且签约链接短信发送至当前待绑定手机号 |
前端回调参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
50 |
是 |
请求流水号 |
|
signNum |
String |
60 |
是 |
商户会员编号 |
|
bindResult |
String |
1 |
是 |
绑定结果: |
1:成功 |
phone |
String |
11 |
是 |
绑定手机号 |
【绑定手机号通知】
绑定手机号成功,发送异步通知!
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
|
reqTraceNum |
String |
50 |
是 |
请求流水号 |
|
signNum |
String |
60 |
是 |
商户会员编号 |
|
bindResult |
String |
1 |
是 |
绑定结果 |
1:成功 2:失败 |
bindErrorMsg |
String |
200 |
否 |
绑定失败原因 |
|
bindTime |
String |
20 |
否 |
绑定时间 |
|
phone |
String |
11 |
是 |
绑定手机号 |
|
phoneType |
String |
1 |
否 |
绑定手机类型 |
1-法人手机号 2-企业授权手机号 注:企业会员绑定手机号,必填 |
绑定手机类型为2-企业授权:法人人脸验证H5页面