3.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. 后续会员协议签约,签约短信发到此手机进行签约验证。

会员类型

绑定手机类型

前置条件

验证方式

发送短信验证码

处理说明

个人会员

/

注册成功或实名成功(会员状态=待生效/有效)

短信验证

发送短信

短信验证通过,则绑定手机成功

短信验证不通过,则绑定手机失败

企业会员

法人手机号

会员实名成功(会员状态=有效)

运营商三要素验证+短信验证

运营商三要素验证通过,则发送短信验证码

短信验证通过,则绑定手机成功

短信验证不通过,则绑定手机失败

企业授权手机号

法人(人脸识别)签订授权委托书

/

授权协议签约成功,则绑定手机成功

授权协议签约失败,则绑定手机失败,需要重新发起。

业务请求参数

字段

字段类型

必填

字段名称

说明

reqTraceNum

String

请求流水号

 

signNum

String

商户会员编号

 

phone

String

绑定手机号

 

phoneType

String

绑定手机类型

1-法人手机号

2-企业授权手机号

注:企业会员绑定手机号,必填

authPerInfo

JSONObject

被授权人信息

当企业会员通过(2-企业授权手机号)类型绑定手机号,必填

jumpUrl

String

前端跳转地址

仅上送2-企业授权手机号,可上送此字段

notifyUrl

String

签约结果通知地址

 

业务响应参数

字段

字段类型

必填

字段名称

说明

respTraceNum

String

响应流水号

业务正常处理,则返回

signNum

String

商户会员编号

 

respCode

String

业务码

00000:代表成功

66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。

其他返回码:均代表失败

respMsg

String

失败原因

 

signUrl

String

授权手机号签约链接(有效时间7天)

若绑定手机类型为2-企业授权手机号时返回,且签约链接短信发送至当前待绑定手机号

被授权人信息

字段

字段类型

必填

字段名称

说明

authPerName

String

被授权人姓名

 

authPerCerNum

String

被授权人证件号

SM4加密

authPerCerType

String

被授权人证件类型

见枚举值,支持多种证件类型

前端回调参数

签约成功,回调jumpUrl地址。

字段

字段类型

必填

字段名称

说明

reqTraceNum

String

请求流水号

 

signNum

String

商户会员编号

 

bindResult

String

绑定结果:

1:成功

phone

String

绑定手机号

 

【绑定手机号通知】

绑定手机号成功,发送异步通知!

字段

字段类型

必填

字段名称

说明

reqTraceNum

String

请求流水号

 

signNum

String

商户会员编号

 

bindResult

String

绑定结果

1:成功

2:失败

bindErrorMsg

String

绑定失败原因

 

bindTime

String

绑定时间

 

phone

String

绑定手机号

 

phoneType

String

绑定手机类型

1-法人手机号

2-企业授权手机号

注:企业会员绑定手机号,必填

 

绑定手机类型为2-企业授权:法人人脸验证H5页面


maxy2 2024年9月2日 17:20 收藏文档