测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码(transCode):1050
功能说明:
支持签订协议类型=1-簿记账户开户协议。
(1)薄记账户协议签约:
每个会员均需要签订账户提现协议、会员关系证明函(平台统一资金收款的模式下,从真实业务管理及资金流考虑,调整为会员与平台签订关系证明的模式。因此新增平台与会员的“会员关系证明函”,平台内每个会员必须签约)
注:特殊业务场景下,需要按照会员角色签订收款协议、分账协议。
- 前置条件:
协议类型 |
协议说明 |
会员关系证明函 |
个人会员:会员状态=“有效”+未签订此协议+已绑定手机号 企业会员:会员状态=“有效”+未签订此协议+已绑 |
收款协议 |
个人会员:会员状态=“有效”+设置收款方角色+未签订收款协议+已绑定手机号 企业会员:会员状态=“有效”+设置收款方角色+未签订收款协议+已绑定手机号 |
分账协议 |
个人会员:会员状态=“有效” 收款方:设置收款方角色+存在未签订的分账协议+已绑定手机号 分账方:设置分账方角色+存在未签订的分账协议+已绑定手机号: 企业会员:会员状态=“有效”, 收款方:设置收款方角色+存在未签订分账协议+已绑定手机号 分账方:设置分账方角色+存在未签订分账协议+已绑定手机号 |
账户提现协议 |
个人会员(个人户名):会员状态=“有效”+未签订账户提现协议+绑定手机号 企业会员(企业户名签约)=“有效”+已绑定手机+未签订账户提现协议 |
业务请求参数
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
是 |
请求流水号 |
|
signNum |
String |
是 |
签约会员编号 |
若上述收款方角色的会员,可在签约协议信息中上送分账会员信息,签订分账协议 |
memberName |
String |
是 |
签约会员名称 |
需签订分账协议的场景 此字段填收款会员信息; 分账会员信息在签约协议信息中明确 |
agreementType |
String |
是 |
协议类型 |
1-簿记账户开户协议 |
agreementJson |
JSONObject |
否 |
签约协议信息 |
当协议类型=1-簿记账户开户协议:上送“薄记账户开户协议详情信息” |
jumpPageType |
String |
否 |
跳转页面类型 |
1-H5页面 2-小程序页面 兼容存量模式,不上送默认跳转H5页面 |
jumpUrl |
String |
否 |
前台跳转地址 |
签约成功,则跳转 |
notifyUrl |
String |
是 |
签约结果通知地址 |
业务响应参数
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
respTraceNum |
String |
否 |
响应流水号 |
业务正常处理,则返回 |
respCode |
String |
是 |
业务码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
是 |
失败原因 |
|
signAgreementUrl |
String |
否 |
收款方角色签订的相关协议签约地址 |
00000-申请成功,返回说明:72小时有效期均可打开签约 |
sepAgreementUrl |
String |
否 |
分账方角色签订的相关协议签约地址 |
00000-申请成功,返回; |
簿记账户开户前端页面回调参数
签约成功,回调jumpUrl地址。
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
|
reqTraceNum |
String |
是 |
请求流水号 |
||
signNum |
String |
是 |
签约会员编号 |
||
memberName |
String |
是 |
签约会员名称 |
||
payeeAgreeStatus |
String |
否 |
收款协议签约状态 |
||
payeeAgreementNo |
String |
否 |
收款协议编号 |
||
withdrawAgreeStatus |
String |
否 |
账户提现协议状态 |
0:未签约 1:签约成功 2:签约失败 3:签约中 |
|
withdrawAgreeNo |
String |
否 |
账户提现协议签约编号 |
||
membershipNo |
String |
否 |
签约会员的会员关系证明函编号 |
|
|
membershipStatus |
String |
否 |
签约会员的会员关系证明函状态 |
0:未签约 1:签约成功 2:签约失败 3:签约中 |