一、文档说明

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

二、安全认证与签名

1.签名方法2.AES加密

三、结算公司和资金余额

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

四、实时发放

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

五、业务级错误代码

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

六、枚举类型

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

一. 接口介绍

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

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

二.接口业务逻辑

  1. 第一步【查询资金池余额】,根据余额情况决定是否可以发起提现上报。
  2. 发起提现上报,需要注意的是上报接口仅用于将提现数据上报至理账狮SaaS系统,上报结果请通过【异步通知】获取。同一业务流水号数据仅可上报一次。如遇到系统超时或404等未得到同步反馈,请不要在重新上报时更换流水号,更换流水号将被视为新批次数据,按照正常流程处理,会导致业务偏离,引起数据超发的风险。
  3. 查询提现结果,当回调不能正常接收时,手动查询提现结果使用。该接口一般用于异步通知失败补救使用,切勿定时大批量发起,以免被拦截。
  4. 提现结果异步通知,理账狮SaaS系统在收到银行发放结果通知后,会按照上报数据指定的回调地址推送提现结果,正常情况下1-3分钟以内将会得到结论,如果遇到银行订单堆积,回调时长顺延。