# 使用必读

#
为实现与平台的支付接口顺利对接,请相关技术务必详细阅读

# (一) 接口约定

1.安全认证 调用方按照约定好的算法生成签名字符串,作为请求的一部分,接口提供方验算签名即可知是否合法 步骤通常如下: ①接口提供方即平台给出companyId和apiSecret ②调用方根据companyId和apiSecret以及请求参数,按照一定算法生成签名sign,具体算法参考下面签名算法 ③接口提供方验证签名 2.传输协议 HTTPS 3.超时时间 普通接口超时时间最长5秒,支付扣款接口建议最长超时时间60秒

# (二) 接口参数

1.接口参数格式 接口参数格式定义如下: ①请求参数格式application/json,如{"id":1,"name":"张三"} ②返回参数格式application/json,如{"id":1,"name":"张三"} 2.请求参数类型 2.1.公共参数

参数名 必选 类型 说明
companyId string 渠道ID
apiSecret string 请求来源渠道的密钥
sign string API输入参数签名结果,签名算法介绍参照下面的介绍
timestamp string 时间戳,北京时间总毫秒数(13位时间戳)
requestId string 请求ID,需要保证调用侧全局唯一

本系统允许客户端请求最大时间误差为5秒钟

2.2.业务参数  API调用除了必须包含公共参数外,如果API本身有业务级的参数也必须传入,每个API的业务级参数请参考下面接口列表说明

# (三) 签名算法

1.根据请求参数,对签名进行验证,签名不合法的请求将会被拒绝 2.生成签名的步骤如下: ①将所有业务请求参数及公共参数(剔除sign以及所有类型为object和list的参数),按字母先后顺序排序 ②将参数转换成JSON字符串得到字符串A,特别注意这里JSON字符串没有空格 ③在字符串A的首尾加上apiSecret组成一个新字符串B 譬如: 123456{"apiSecret":"123456","companyId":"1237921217513394176","requestId":"5e280118-a07e-42ee-b69d-c62b5a9a81a5","timestamp":"1644808737982","type":"2"}123456 ④对字符串B进行md5,取32位小写,得到签名sign

# (四) 接口地址

统一接口域名 https://openapi.zfkjgw.com

# (五) 支付流程图

# (六) 调用示例

平台 示例项目 参考类
JAVA 码云链接 (opens new window) com.huishua.openapiexample.company.CompanyApiDemo
上次更新: 6/14/2022, 8:30:30 AM