平台提供丰富的开放接口，企业可以根据自己的业务场景、技术选型等因素来自由组合接口，以满足对接需求。如果平台现有接口无法满足您的对接需求，请通过销售经理联系技术支持进行个性化接口沟通。

我们将几个常见的应用场景进行了一些整理，方便企业快速对照开发。

1、业务签约

场景介绍：企业有自己的APP(或者H5,小程序等其他系统)，企业希望个人在自己的APP内，通过内嵌H5链接的方式，完成跟平台服务商业务签约流程。

企业可以调用业务签约接口组里的相关接口实现上述场景。

注意事项：

1）关于个人签约状态：企业需保存个人签约状态，根据状态判断是否要签约。

2）关于收款账号：签约时，平台收集的个人收款账号信息，只是方便部分企业发起结算(部分企业没有个人结算信息)，实际在向个人结算时，平台支持可以向个人多个收款账户进行结算。另外，在签约过程中，平台默认收集个人银行卡作为收款账号，如果需要调整为支付宝或者不手机个人收款账号信息时，请联系客服进行配置变更。

3）关于回调方式：我们强烈建议企业通过1.6 回调签约结果最终确认个人签约结果(前端url回跳在个人客户端浏览器控制，由于客户端原因，可能会导致前端URL回跳失败)。

建议接口调用顺序：

序号	接口	说明
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个批次。

建议接口调用顺序：

序号	接口
1	获取accessToken.	所有接口都需要accessToken，accessToken2小时内有效，可重复使用。
2	2.2 添加订单	结算下单，确保企业余额充足，订单受理也是异步受理，订单提交成功并不代表会处理。
3	2.6 回调提现结果	返回订单提现结果
4	2.3 查询单个订单	可选，可以查询订单结果

3、批量交易

当企业有自己的APP(或者H5,小程序等其他系统)，企业希望批量向平台发起结算(付款)，那么企业可以调用批量交易接口组里相关接口实现该业务场景。

注意事项：

1）企业(个人)发起批量结算(提现)前，先使用业务签约相关接口完成业务签约，结算的个人必须先跟当前服务商完成业务签约。

2）此场景一般需要企业进行人工交互确认，所以时效性没有实时结算(企业提现)场景高。

3）受到银行、第三方支付影响，结算(支付)过程是异步处理，结算(支付)结果也是异步返回。

4）此场景下单和项目付款步骤分开，所以可以先制单，后付款。

5）该场景批量操作，交互细节相对复杂一点，我们建议企业尽量前往SAAS系统自助操作，只使用下单和回调接口。

建议接口调用顺序：

序号	接口名称	说明
1	获取 accessToken	所有接口都需要 `accessToken`，`accessToken` 2小时内有效，可重复使用。
2	4.1 创建交易订单	下单，该过程平台是异步处理，订单提交成功并不代表会立即处理，以回调结果为准。
3	4.8 回调交易进展	平台返回订单进展（订单是否受理），明细数据不会返回，需要企业自主查询。
4	4.6 查询订单明细	可选，查询订单明细结果。
5	4.2 确认支付订单	该步骤可以在 SAAS 平台人工操作，必须先充值。
6	4.8 回调交易进展	平台返回订单进展（订单是否交易完成），明细数据不会返回，需要企业自主查询。
7	4.6 查询订单明细	查询订单每天明细结算（支付）结果。

场景介绍

1、业务签约#

2、实时提现#

3、批量交易#

1、业务签约

2、实时提现

3、批量交易