版本信息
- 版本号：V1.0.0
- 编辑者：张颖
- 更新时间：2024/08/08
- 更新内容：创建
接口说明
文档提供服务SDK或APP调用，内容包含：请求参数，响应参数，状态说明信息。请求方式HTTP或HTTPS，敏感信息进行加密。
请求地址与方式
接口列表
| 接口名称 | 请求地址 | 请求方式 | 说明 |
|---|
| 下载参数 | api/unattended/down/param | POST | 集成模式和收单模式 |
| 下载主密钥 | api/unattended/down/pmk | POST | 收单模式 |
| 签名 | api/unattended/signature | POST | API调用-签名获取 |
| ... | ... | ... | ... |
| 字段名 | 类型 | 是否必传 | 字段名称 | 说明 |
|---|
| interfaceVersion | String | 是 | 版本号 | 1.0.0 |
| appVersion | String | 是 | 应用版本 | 注意：saas云端不需要传 |
| interfaceName | String | 是 | 接口名称 | |
| ... | ... | ... | ... | ... |
响应公共参数信息
| 字段名 | 类型 | 是否必传 | 字段名称 | 说明 |
|---|
| currentDate | String | 是 | 请求时间 | 请求时当 前时间 |
| respDate | String | 是 | 响应时间 | |
| respCode | String | 是 | 响应码 | 200：成功，400：错误，500：异常 |
| respErrorMsg | Object | 否 | 错误信息 | 错误信息 (异常状态有值) |
| dataMsg | Object | 否 | 业务数据信息 | 正常状态有值 |
系统层接口
下载参数
- 请求地址：
/api/unattended/down/param
- 请求参数：请求header公共参数信息
下载主密钥
- 请求地址：
/api/unattended/down/pmk
- 请求参数：请求header公共参数信息
交易层接口
预授权
- 请求地址：
/api/unattended/authorize
- 请求参数：请求header公共参数信息
预授权撤销
- 请求地址：
/api/unattended/revoke
- 请求参数：请求header公共参数信息
...（其他接口）
响应状态码及对应响应信息
| respCode | 描述 | respErrorMsg | errorCode | errorMsg |
|---|
| 200 | 成功 | - | - | - |
| 400 | 错误 | 参数为空 | - | - |
| 401 | 未授权 | - | - | - |
| 403 | 访问授权 | - | - | - |
| 410 | 终端信息异常 | - | - | - |
| 420 | 商户信息异常 | - | - | - |
| 440 | 交易信息异常 | - | - | - |
| 500 | 系统异常 | - | - | - |
| 504 | 请求超时 | - | - | - |