测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码(transCode):1050
功能说明:
支持签订协议类型=1-簿记账户开户协议和协议类型=2-支付账户开户协议签订。
(1)薄记账户协议签约:每个会员均需要签订账户提现协议、会员关系证明函。
(2)支付账户协议签约:按会员角色查询需要签订支付账户开户相关的协议:【通联支付账户服务协议】、【客户业务合作确认函】、【非自然人客户受益所有人信息登记表】(三份协议必须同时签订)
- 前置条件:
协议类型 |
协议说明 |
会员关系证明函 |
个人会员:会员状态=“有效”+未签订此协议+已绑定手机号 企业会员:会员状态=“有效”+未签订此协议+已绑定手机号 |
账户提现协议 |
个人会员(个人户名):会员状态=“有效”+未签订账户提现协议+绑定手机号 企业会员(企业户名签约)=“有效”+已绑定手机+未签订账户提现协议 |
支付账户协议 |
个人会员:会员状态=“有效”+已绑定手机号+“支付账户状态=待激活” 企业会员:会员状态=“有效”+已绑定手机号+“支付账户状态=待激活” |
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
50 |
是 |
请求流水号 |
|
signNum |
String |
60 |
是 |
签约会员编号 |
|
memberName |
String |
32 |
是 |
签约会员名称 |
|
agreementType |
String |
1 |
是 |
协议类型 |
1-簿记账户开户协议 2-支付账户开户协议 注:2-支付账户开户协议仅支持企业会员 |
jumpPageType |
String |
1 |
否 |
跳转页面类型 |
1-H5页面 2-小程序页面 兼容存量模式,不上送默认跳转H5页面 |
jumpUrl |
String |
256 |
否 |
前台跳转地址 |
签约成功,则跳转 |
notifyUrl |
String |
256 |
是 |
签约结果通知地址 |
业务响应参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
respTraceNum |
String |
40 |
否 |
响应流水号 |
业务正常处理,则返回 |
respCode |
String |
5 |
是 |
业务码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
200 |
是 |
失败原因 |
|
signAgreementUrl |
String |
256 |
否 |
会员签订的相关协议签约地址 |
00000-申请成功,返回说明:72小时有效期均可打开签约 |
簿记账户开户前端页面回调参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
50 |
是 |
请求流水号 |
|
signNum |
String |
60 |
是 |
签约会员编号 |
|
memberName |
String |
32 |
是 |
签约会员名称 |
|
withdrawAgreeStatus |
String |
1 |
否 |
账户提现协议状态 |
0:未签约 1:签约成功 2:签约失败 3:签约中 |
withdrawAgreeNo |
String |
32 |
否 |
账户提现协议签约编号 |
|
membershipNo |
String |
|
否 |
签约会员的会员关系证明函编号 |
|
membershipStatus |
String |
|
否 |
签约会员的会员关系证明函状态 |
0:未签约 1:签约成功 2:签约失败 3:签约中 |
支付账户开户前端页面回调参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
50 |
是 |
请求流水号 |
|
signNum |
String |
60 |
是 |
签约会员编号 |
|
memberName |
String |
32 |
是 |
签约会员名称 |
|
payAcctSignStatus |
String |
1 |
是 |
支付账户协议签约状态 |
0:未签约 1:签约成功 2:签约失败 3:签约中 |
payAcctAgreeNo |
String |
32 |
否 |
支付账户协议编号 |