2.6【会员绑定手机号申请】


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

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

接口代码(transCode):1030

 

功能说明:

  1. 个人会员注册或实名成功(即会员状态=待生效/有效),则可以申请绑定手机号,申请成功,发送短信验证码。
  2. 企业会员实名成功(即会员状态=有效),才可以申请绑定手机号。
  3. 可通过【查询会员信息】接口查询会员已绑定的手机号。
  4. 后续会员签约签约发到此手机进行签约验证。
  5. 验证码有效期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页面

表格描述已自动生成


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