测试地址：https://ibstest.allinpay.com/yst/yst-service-api/tm/handle
生产地址：https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码（transCode）：1016
功能说明：
支持通联管理模式下会员完成合规资料补录和《通联支付特约商户综合支付服务协议（平台二级商户）》协议签署；
- 前提：仅支持资金管理模式为通联管理的应用，且必须是完成绑定手机号的会员才可以调用本接口。
- 本接口支持向需要进行商户信息补录或者特约商户协议签约的会员响应H5链接，客户可在通联的页面上依次完成：特约商户信息补录、协议签约（两个环节不是一定存在，根据实际业务需要返回）
- 针对“合规信息补录状态”为“未补录”的会员，需要在H5反显后台已经存储的相关信息
- 本H5页面支持在小程序环境打开
- 页面支持断点继续操作
- 提交至最后一步完成操作后，将向商户发送【商户信息补录及协议签约结果通知】
- 上送业务请求参数后，请求成功后，接口通过业务响应参数同步响应商户信息补录及协议签约H5页面链接，请于H5或者小程序环境打开此链接
- 完成所需的信息补录或者协议签约后，会跳转至结果页面，结果通知至商户信息补录及协议签约结果通知地址
- 支持客户上送前端回调地址，在H5流程结束后，自动跳转至客户指定页面。
业务请求参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
reqTraceNum |
String |
15 |
是 |
请求流水号 |
|
|
signNum |
String |
50 |
是 |
签约会员编号 |
|
|
notifyUrl |
String |
50 |
是 |
通知地址 |
|
|
jumpUrl |
String |
50 |
是 |
页面跳转地址 |
不带参 |
业务响应参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
respTraceNum |
String |
50 |
是 |
响应流水号 |
|
|
signNum |
String |
50 |
是 |
商户会员编号 |
|
|
respCode |
String |
5 |
是 |
业务返回码 |
000000：代表成功 66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。 其他返回码：均代表失败 |
|
respMsg |
String |
200 |
否 |
业务返回说明 |
|
|
memberInfoAddStatus |
String |
1 |
否 |
商户信息补录状态 |
枚举值如下： 0-无需补录 1-未补录 2-已补录 |
|
specialMerchantServiceStatus |
String |
1 |
否 |
特约商户协议签约状态 |
枚举值如下： 0-无需签署 1-未签署 2-已签署 |
|
memberInfoAddOrAgreementUrl |
String |
500 |
否 |
商户信息补录及协议签约H5-url |
url链接，用户请求成功后，通过此链接可以跳转至商户信息补录及协议签约H5页面 |
商户信息补录及协议签约结果通知
功能说明：
- 【商户信息补录及协议签约H5】页面操作完成后，通过该接口通知特约商户信息补录结果、特约协议签约结果；
- 结果通知情况：
- 需要补录并签约的：补录及签约完成后发送异步通知
- 仅需要补录的：补录完成后发送异步通知
- 仅需要签约的：签约完成后发送异步通知
- 补录结果和签约结果需要同步至管理平台、门户，包括信息落地和状态变更。
业务响应字段
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
reqTraceNum |
String |
50 |
是 |
商户请求流水号 |
商户系统内保持唯一，定义长度为50位 |
|
respTraceNum |
String |
40 |
否 |
响应流水号 |
|
|
signNum |
String |
60 |
是 |
商户会员编号 |
|
|
memberInfoAddResult |
String |
1 |
否 |
商户信息补录结果 |
枚举值如下： 1 成功 0 失败 |
|
specialMerchantServiceResult |
String |
1 |
否 |
特约商户协议签约结果 |
枚举值如下： 1 成功 0 失败 |
|
respMsg |
String |
200 |
否 |
失败说明 |