测试地址：https://ibstest.allinpay.com/yst/yst-service-api/tm/handle
生产地址：https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码（transCode）：1051
功能说明：
- 支持协议类型=1-簿记账户开户协议和协议类型=2-支付账户开户协议线下签订。
（1）薄记账户协议：会员关系证明函、账户提现协议（企业/个人主体）、绑定授权人手机及授权协议文件；
（2）支付账户协议：【通联支付账户服务协议】【客户业务合作确认函】【非自然人客户受益所有人信息登记表】协议文件。
- 通过【文件上传】接口完成协议文件上传，支持png、jpg、zip、pdf格式;
- 线下协议上传成功，待人工审核通过，才代表签约成功；
业务请求参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
reqTraceNum |
String |
50 |
是 |
请求流水号 |
|
|
signNum |
String |
60 |
是 |
签约会员编号 |
|
|
memberName |
String |
32 |
是 |
签约会员名称 |
|
|
agreementType |
String |
1 |
是 |
协议类型 |
1：簿记账户开户协议 2：支付账户开户协议 注：2：支付账户开户协议仅支持企业会员 |
|
agreementJson |
JSONObject |
是 |
签约协议信息 |
当协议类型=1-簿记账户开户协议、以及绑定授权人手机时：上送“薄记账户开户协议详情信息” 当协议类型=2-支付账户开户协议：上送“支付账户开户协议详情信息” |
|
|
notifyUrl |
String |
256 |
是 |
签约结果通知地址 |
薄记账户开户协议详情信息JSON（agreementJson）
|
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
|
payeeAgreeToken |
String |
否 |
签约会员的收款协议文件token |
收款方协议 |
|
withdrawAgreeToken |
String |
否 |
签约会员的账户提现协议文件token |
若会员需要按照企业/个人主体签账户提现协议，则上送文件token |
|
authPerAgreeInfo |
JSONObject |
否 |
签约会员的授权委托协议信息 |
上送，则进行签约 具体字段见【线下授权委托协议（绑定手机号）信息】 |
线下授权委托协议（绑定手机号）信息JSON（authPerAgreeInfo）
|
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
|
authPhone |
String |
是 |
被授权人手机号 |
|
|
authPerName |
String |
是 |
被授权人姓名 |
|
|
authPerCerNum |
String |
是 |
被授权人证件号 |
SM4 加密 |
|
authPerCerType |
String |
是 |
被授权人证件类型 |
见枚举值，支持多种证件类型 |
|
authPerAgreeToken |
String |
是 |
签约会员的授权委托协议文件token |
支付账户开户协议详情信息JSON（agreementJson）
|
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
|
payAcctNoOpenAgreeToken |
String |
是 |
通联支付账户服务协议文件token |
三份必须同时上送 |
|
coopConfirmToken |
String |
是 |
客户业务合作确认函文件token |
|
|
nonNatureCusBenefitToken |
String |
是 |
非自然人客户受益所有人信息登记表文件token |
业务响应参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
respTraceNum |
String |
40 |
否 |
响应流水号 |
业务正常处理，则返回 |
|
signNum |
String |
60 |
否 |
签约商户会员编号 |
|
|
respCode |
String |
5 |
是 |
业务码 |
00000：代表成功 66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。 其他返回码：均代表失败 |
|
respMsg |
String |
200 |
是 |
失败原因 |
多个失败原因可拼接显示 |