3.9【会员线上协议签约申请】接口


测试地址: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:签约中

 

 


maxy2 2025年3月4日 10:43 收藏文档