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


测试地址:https://ibstest.allinpay.com/yst/yst-service-api/tm/handle

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

接口代码(transCode):1030

 

功能说明:

  1. 个人会员注册或实名成功(即会员状态=待生效/有效),则可以申请绑定手机号,申请成功,发送短信验证码。
  2. 企业会员实名成功(即会员状态=有效),才可以申请绑定手机号。
  3. 可通过【查询会员信息】接口查询会员已绑定的手机号。
  4. 后续会员签约签约发到此手机进行签约验证。
  5. 验证码有效期5分钟;
  6. 验证码发送——运营商规则:统一限制同一个号码一分钟只能发一条。

会员类型

绑定手机类型

前置条件

验证方式

发送短信验证码

处理说明

个人会员

/

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

短信验证

发送短信

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

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

企业会员

法人手机号

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

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

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

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

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

企业授权手机号

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

/

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

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

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

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

是

绑定手机号

 

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

表格描述已自动生成


2026年4月9日 17:40 收藏文档