一、文档说明

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

二、安全认证与签名

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

三、结算公司和资金余额

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

四、实时发放

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

五、业务级错误代码

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

六、枚举类型

1. 证件类型2. 支付宝支付交易失败code3. 交易状态4. 导出状态
1. 签名方法

本文将介绍如何使用 MD5 对请求进行签名,并验证签名。

1. 构建待签名字符串

1.1 拼接请求参数

将请求参数列表中除 signature 参数外的所有非 null 的参数按照 ascll升序 规则排序后,按 key=value格式组合后使用 & 进行拼接得到 paramString:

String paramString = "access_key=AccessKey&fileId=2&plat=api&timestamp=1625590924&version=100000"

1.2 拼接待签名字符串

1.1 中拼接的 paramString 继续按下面的方式拼接 AccessKeySecrettimestamp

String signSource = AccessKeySecret + timestamp + paramString

至此,我们得到了准备签名的字符串。

2. 计算待签名字符串的MD5

String signature = MD5Utils.md5(signSource)

3. 将签名加入到请求的参数列表中

{
  "access_key": "AccessKey",
  "plat": "api",
  "timestamp": "1625590924",
  "version": "100000",
  "fileId": "2",
  "signature": signature
}