一、文档说明

1. 写在前面2. 错误代码表

二、安全认证与签名

1. 签名方法2. AES加解密

三、结算公司和资金余额

1. 资金池余额查询2. 税源地公司信息查询

四、实时发放

1. 接口使用流程2. 实时发放数据上报3. 查询实时发放数据4. 实时发放回调通知5. 申请实时发放业务账单6. 查询实时发放业务账单申请状态7. 申请实时发放业务回单

五、业务级错误代码

1. 实时发放接口错误代码2. 数据格式正则校验失败code

六、枚举类型

1. 证件类型2. 支付宝支付交易失败code3. 交易状态4. 导出状态
1. 接口使用流程

实现提现,该功能包括以下几个接口:

  • 提现数据上报: 将采集好的提现信息上报至理账狮SaaS系统,理账狮SaaS系统反馈上报是否成功。(异步通知)
  • 查询提现结果: 返回已经上报成功数据的订单详情。
  • 查询资金池金额: 返回当前主体所有结算公司可用资金余额汇总。

接口业务逻辑

  1. 第一步【资金池余额查询】,根据余额情况决定是否可以发起提现上报。

  2. 发起提现上报,需要注意的是上报接口仅用于将提现数据上报至理账狮SaaS系统,上报结果请通过【异步通知】获取。同一业务流水号数据仅可上报一次。如遇到系统超时或404等未得到同步反馈,请不要在重新上报时更换流水号,更换流水号将被视为新批次数据,按照正常流程处理,会导致业务偏离,引起数据超发的风险。

  3. 查询提现结果,当回调不能正常接收时,手动查询提现结果使用。该接口一般用于异步通知失败补救使用,切勿定时大批量发起,以免被拦截。

  4. 提现结果异步通知,理账狮SaaS系统在收到银行发放结果通知后,会按照上报数据指定的回调地址推送提现结果,正常情况下1-3分钟以内将会得到结论,如果遇到银行订单堆积,回调时长顺延。