一、文档说明

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

二、安全认证与签名

1.签名方法2.AES加密

三、结算公司和资金余额

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

四、实时发放

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

五、业务级错误代码

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

六、枚举类型

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

说明:

  • 对于每一次API请求,我们会根据访问中的签名信息验证访问请求者身份。
  • AccessKeyIDAccessKeySecret以SaaS入驻主体为单位,一个账号一套。
  • AccessKey相当于用户密码,AccessKey用于调用API,而用户密码用于登录管理后台。其中AccessKeyID是访问者身份,AccessKeySecret是加密签名字符串和服务器端验证签名字符串的密钥,必须严格保密谨防泄露。

步骤一:构造规范化请求字符串

  1. 排序参数。排序规则以首字母顺序排序,排序参数包括公共请求参数和接口自定义参数,不包括公共请求参数中的Signature参数。

当使用GET方法提交请求时,这些参数就是请求URL中的参数部分,即URL中?之后由&连接的部分。

在对请求的参数做签名时,对于请求参数列表中那些可空的参数,如果选择使用它们,那么这些参数的参数值必须不能为null

没有值的参数无需传递,也无需包含到待签名数据中.

待签名数据应该是参数原始值而不是url encoding之后的值,例如:调用某接口需要对请求参数email进行数字签名,那么待签名数据应该是email=test@test.com,而不是email=test%40test.com

  1. 编码参数。使用UTF-8字符集按照application/x-www-form-urlencodedMIME规则编码请求参数和参数取值,编码规则如下:
  • 字符A-Z、a-z、0-9以及字符-_.~不编码。
  • 其它字符编码成%XY的格式,其中XY是字符对应ASCII码的16进制。示例:半角双引号(")对应%22
  • 扩展的UTF-8字符,编码成%XY%ZA…的格式。
  • 空格( )编码成+,而不是%20。
  1. 使用等号(=)连接编码后的请求参数和参数取值。
  2. 使用与号(&)连接编码后的请求参数,注意参数排序与步骤1一致。

现在,您得到了规范化请求字符串(CanonicalizedQueryString),其结构遵循请求结构。

步骤二:构造签名字符串

  1. 构造待签名字符串StringToSign
StringToSign=
  AccessKeySecret + //我们分配给您的AccessKeySecret。
  Timestamp + // 当前时间时间戳,单位为秒。
  CanonicalizedQueryString //您的规范化请求字符串。
  1. 计算待签名字符串StringToSignMD5值。
Signature = MD5Utils.md5( StringToSign )
  1. 添加计算后的参数Signature到规范化请求字符串URL中。