一、文档说明

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

二、安全认证与签名

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

三、结算公司和资金余额

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

四、实时发放

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

五、业务级错误代码

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

六、枚举类型

1. 证件类型2. 支付宝支付交易失败code3. 交易状态4. 导出状态
2. 税源地公司信息查询
  • 获取合作企业税源地公司(结算公司)信息列表,投产时请以接口反馈为准
  • 合作企业与理账狮 SaaS签署合作协议时,可能是一对多的情况,即同时签署理账狮 SaaS多家税源地(结算公司)公司。进行服务费发放时,根据自身的业务情况以及合作细节决定选择哪个税源地(结算公司)进行发放
  • 每个税源地提供的支付能力是不同的(支付宝、微信、银行卡),请在使用相关支付类型进行订单上报时先行确认税源地提供能力。
  • 服务类型与服务费发放完成后的开票类目有直接关系,如果接口反馈的服务类型信息有多个,详询业务人员具体使用哪一个。
  • 此处数据可以设置为常量,但应该支持配置,可持久化在配置文件或者数据库中,需要更换时可以随时切换,不能写死在代码中。

请求URL

basics/getTaxFundList

请求参数

参数名 必选 类型 说明
plat string 来源,本接口固定值:api
version string 接口版本, 本接口固定值:100000
access_key string 平台分配给商户唯一ID
timestamp string 请求时的时间戳,示例:1625590924
signature string 签名字符串

返回参数说明

参数名 类型 说明
code number 状态码
msg string 信息
data object
id string 税源地 ID
name string 税源地公司名称
taxnumber string 税源地公司税号

返回示例

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "id": 1,
      "name": "[沙箱]湖南牧夫信息科技服务有限公司",
      "taxnumber": "91430381MA4T44T594"
    }
  ]
}