场景介绍
平台提供丰富的开放接口,企业可以根据自己的业务场景、技术选型等因素来自由组合接口,以满足对接需求。如果平台现有接口无法满足您的对接需求,请通过销售经理联系技术支持进行个性化接口沟通。
我们将几个常见的应用场景进行了一些整理,方便企业快速对照开发。
1、业务签约
场景介绍:企业有自己的APP(或者H5,小程序等其他系统),企业希望个人在自己的APP内,通过内嵌H5链接的方式,完成跟平台服务商业务签约流程。
企业可以调用业务签约接口组里的相关接口实现上述场景。
注意事项:
1)关于个人签约状态:企业需保存个人签约状态,根据状态判断是否要签约。
2)关于收款账号:签约时,平台收集的个人收款账号信息,只是方便部分企业发起结算(部分企业没有个人结算信息),实际在向个人结算时,平台支持可以向个人多个收款账户进行结算。另外,在签约过程中,平台默认收集个人银行卡作为收款账号,如果需要调整为支付宝或者不手机个人收款账号信息时,请联系客服进行配置变更。
3)关于回调方式:我们强烈建议企业通过1.6 回调签约结果最终确认个人签约结果(前端url回跳在个人客户端浏览器控制,由于客户端原因,可能会导致前端URL回跳失败)。
下面是我们建议的交互流程图:
.png>)
建议接口调用顺序:
序号 | 接口 | 说明 |
---|---|---|
1 | 获取accessToken. | 所有接口都需要accessToken,accessToken2小时内有效 ,可重复使用。 |
2 | 1.2添加自由职业者 | 在平台注册自由职业者 |
3 | 1.3获取用户token | 未该自由职业者申请一个临时 userToken |
4 | 1.4页面签约跳转 | 这里只是一个签约跳转url拼凑说明,个人查看合同也是跳转到该链接。平台会根据个人签约状态自动 跳转至签约流程页面 |
5 | 1.5查询签约结果 | 可选接口,查询确认个人签约结果 |
6 | 1.6回调签约结果 | 可以使用回调响应签约结果,url回跳存在不确定性 |
2、实时提现
当企业有自己的APP(或者H5,小程序等其他系统),企业希望个人在企业APP内发起业务结算(提现)时,我方平台能够实时(及时)全自动结算(付款)到个人,那么企业可以调用实时提现接口组里相关接口实现该业务场景。
注意事项:
1)企业实时提现功能,默认关闭,如果需要开通,请联系客服进行开通,在开通时,请告知客服个人到账方式(银行卡/支付宝),客服将针对到账方式进展配置。
2)企业(个人)发起实时结算(提现)前,先使用业务签约相关接口完成业务签约,结算的个人必须先跟当前服务商完成业务签约才能发起提现。
3)企业必须预充值费用到服务商,服务商不会进行结算费用垫付,企业余额不足时,结算会直接失败。
4)受到银行、第三方支付影响,结算(支付)过程是异步处理,结算(支付)结果也是异步返回。
5)企业预充值,请登录SAAS系统根据提示进行充值操作。
6)基于安全考虑,实时提现相关接口,并且需要企业提前配置IP白名单。
7)月末2天的提现金额只能次月申请发票,由于发票基于批次进行申请,系统会定期将提现明细进行批次归集(不影响提现功能),提现明细批次归集逻辑:从1号起每5天归集成1个批次,月末2天单独归集1个批次。
下面是我们建议的交互流程图:
.png>)
建议接口调用顺序:
序号 | 接口 | |
---|---|---|
1 | 获取accessToken. | 所有接口都需要accessToken,accessToken2小时内有效 ,可重复使用。 |
2 | 2.2 添加订单 | 结算下单,确保企业余额充足,订单受理也是异步受理,订单提交成功并不代表会处理。 |
3 | 2.6 回调提现结果 | 返回订单提现结果 |
4 | 2.3 查询单个订单 | 可选,可以查询订单结果 |
3、批量交易
当企业有自己的APP(或者H5,小程序等其他系统),企业希望批量向平台发起结算(付款),那么企业可以调用批量交易接口组里相关接口实现该业务场景。
注意事项:
1)企业(个人)发起批量结算(提现)前,先使用业务签约相关接口完成业务签约,结算的个人必须先跟当前服务商完成业务签约。
2)此场景一般需要企业进行人工交互确认,所以时效性没有实时结算(企业提现)场景高。
3)受到银行、第三方支付影响,结算(支付)过程是异步处理,结算(支付)结果也是异步返回。
4)此场景下单和项目付款步骤分开,所以可以先制单,后付款。
5)该场景批量操作,交互细节相对复杂一点,我们建议企业尽量前往SAAS系统自助操作,只使用下单和回调接口。
下面是我们建议的交互流程图:
.png>)
建议接口调用顺序:
序号 | 接口 | |
---|---|---|
1 | 获取accessToken. | 所有接口都需要accessToken,accessToken2小时内有效 ,可重复使用。 |
2 | 4.1 创建交易订单 | 下单,该过程平台是异步处理,订单提交成功并不代表会处理,以回调结果为准。 |
3 | 4.8 回调交易进展 | 平台返回订单进展(订单是否受理),明细数据不会反回,需要企业自主查询。 |
4 | 4.6 查询订单明细 | 可选,查询订单明细结果 |
5 | 4.2 确认支付订单 | 该步骤可以在SAAS平台人工操作,必须先充值。 |
6 | 4.8 回调交易进展 | 平台返回订单进展(订单是否交易完成),明细数据不会反回,需要企业自主查询。 |
7 | 4.6 查询订单明细 | 查询订单每天明细结算(支付)结果 |