测试地址：https://ibstest.allinpay.com/yst/yst-service-api/tm/handle
生产地址：https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码（transCode）：1012
功能说明：
1.该接口仅支持个人会员以前台H5页面形式完成个人会员的注册+设置角色+个人实名信息采集+绑定手机号；
2.链接有效期为7天，过期后打开链接提示：已过期，请重新开始个人会员开户H5流程；
3.若客户上送“backUrl-异步通知地址”，则云商通提供异步结果通知，其中手机号绑定完成、协议签约完成均会给出异步通知；
4.若客户上送“jumpUrl-成功跳转页面地址”，则云商通在H5页面流程结束后跳转到该页面；
5.客户在微信小程序内调起签约功能的，采取跨小程序跳转方式对接，对接指引详见《小程序应用客户对接云商通H5页面类接口接入指引.docx》
测试参数说明：
测试环境四要素绑卡结果模拟规则如下:
卡号第四位为0，交易成功（可以使用：621026开头，19位卡号的卡）
卡号第四位为1，查开户方原因
卡号第四位为2，无效卡号（可以使用：621226开头，19位卡号的卡）
卡号第四位为3，已挂失卡
卡号第四位为4，余额不足
卡号第四位为5，无此账户（可以使用：621226开头，19位卡号的卡）
卡号第四位为6，原交易失败，不收费
卡号第四位为7，户名错
卡号第四位为8，交易超时
业务请求参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
reqTraceNum |
String |
50 |
是 |
商户请求流水号 |
商户系统内保持唯一，定义长度为50位 |
|
signNum |
String |
60 |
是 |
商户会员编号 |
已注册或未注册的会员 |
|
memberRole |
String |
60 |
否 |
会员角色 |
接口非必填，若上送，校验如下： （1）未注册会员/审核失败的会员（会员状态=审核失败）， （2）已注册会员设置角色(会员状态=待生效)，必须与设置角色一致，否则报错 |
|
name |
string |
32 |
是 |
姓名 |
|
|
jumpPageType |
String |
1 |
否 |
跳转页面类型 |
1-H5页面 2-小程序页面 接口非必填，不上送默认跳转H5页面 |
|
backUrl |
String |
256 |
是 |
异步通知 |
必填，个人会员注册（H5）流程的异步通知地址； |
|
jumpUrl |
String |
256 |
否 |
成功跳转返回的页面地址 |
非必填，成功则跳转； |
业务响应参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
respTraceNum |
String |
40 |
是 |
响应流水号 |
|
|
signNum |
String |
60 |
否 |
商户会员编号 |
00000，成功返回 |
|
respCode |
String |
5 |
是 |
业务返回码 |
|
|
respMsg |
String |
200 |
否 |
失败原因 |
|
|
regInviteLink |
String |
256 |
否 |
会员注册链接 |
默认有效期7天 |
jumpUrl前端回调参数
|
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
|
reqTraceNum |
String |
是 |
商户请求流水号 |
商户系统内保持唯一，定义长度为50位 |
|
signNum |
String |
是 |
商户会员编号 |
|
|
name |
String |
是 |
会员名称 |
如有括号，用中文格式（） |
|
auditResult |
String |
是 |
审核结果： |
2：审核成功。 3：审核失败。 |
|
auditTime |
String |
是 |
审核时间 |
格式：20240226170408 |
|
remark |
String |
否 |
人工审核备注 |
|
|
auditResultMsg |
String |
否 |
失败原因 |
1.会员审核失败，则返回会员审核失败原因 |
|
phone |
String |
否 |
绑定手机号 |
绑定手机号成功，发送 |
|
elecAgreeStatus |
String |
否 |
收单协议状态 |
页面签订收单协议，签订成功发送异步通知 |
|
elecAgreementNo |
String |
否 |
收单协议签约编号 |
【绑定手机号通知】
绑定手机号成功，发送异步通知！
|
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
|
|
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-企业授权手机号 注：企业会员绑定手机号，必填 |
【会员协议签约结果通知】
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
reqTraceNum |
String |
50 |
是 |
商户请求流水号 |
商户系统内保持唯一，定义长度为50位 |
|
signNum |
String |
60 |
是 |
签约方的会员编号 |
|
|
memberName |
String |
32 |
是 |
签约会员名称 |
|
|
elecAgreeStatus |
String |
1 |
否 |
收单协议状态 |
收单协议返回 0：未签约 1：签约成功 2：签约失败 3：签约中 |
|
elecAgreementNo |
String |
32 |
否 |
收单协议签约编号 |
收单协议返回 |
|
elecAgreeTime |
String |
20 |
否 |
收单协议签约时间 |
收单协议返回 |