1 文档说明
1.1 文档目的
本文档是为银企云协议支付API产品定义一个接口规范，以帮助商户技术人员快速接入银企云协议支付API网关，并快速掌握其相关功能，便于尽快的投入使用。
1.2 阅读对象
- 商户开发人员、维护人员和管理人员
- 银企云协议支付API产品相关的技术人员
1.3 技术支持
在开发或使用银企云协议支付API接口时，如果您有任何技术上的疑问，请按如下方式寻求帮助，相关技术支持人员会及时处理，给予您答复：
技术支持热线：021-68819999-8005
技术支持Email：support@baofoo.com
技术支持QQ：800066689
1.4 术语与定义
1.4.1 符号含义
| 序号 | 符号缩写 | 符号性质 | 符号说明 |
|---|---|---|---|
| 1 | M | 强制域(Mandatory) | 必须填写的属性，否则会被认为格式错误 |
| 2 | C | 条件域(Conditional) | 某条件成立时必须填写的属性 |
| 3 | O | 选用域(Optional) | 选填属性 |
| 4 | R | 原样返回域(Returned) | 必须与先前报文中对应域的值相同的域 |
数据类型
类型语法：[Max][Min][Size][Type]
Max:可选描述符，如果出现，则说明业务要素的长度最大为Size
Min:可选描述符，如果出现，则说明业务要素的长度最小为Size
Size：强制描述符，指定业务要素UTF-8编码前的最大字符数。
Type：强制描述符，指定业务要素的类型属性。Type主要属性如下
| 序号 | 字段类型Type | 符号说明 |
|---|---|---|
| 1 | code | 编码枚举型数据，具体枚举类型见附录：枚举类型 |
| 2 | Text | 字符串 |
| 3 | Numeric | 数字 |
| 4 | ISODateTime | 日期时间，格式为 yyyy-MM-dd HH:mm:ss ,如:2017-12-20 21:54:21 |
字符集及编码
报文采用Unicode字符集，UTF-8编码方式。
保留字
报文内容中“|”、“%”、 “#”、 “^”、 “-”等为局部保留字，在相关以此类字符作为分隔符的复合字段中不应出现。
1.4.2 术语含义
- 商户号：科技服务方提供给商户的唯一编号，是商户在科技服务方的唯一标识；
- 商户流水号：商户请求科技服务方时提交的流水号，每次请求均不可重复；
1.5 通讯模式
采用HTTPS方式进行通讯。
1.6 报文说明
1.6.1 请求报文
请求报文格式
key1=value1&key2=value2&key3=value3…
签名算法
将除签名字段之外的不为空的字段按key-value的形式构建TreeMap<String, String>对象，按key1=value1&key2=value2…模式将TreeMap对象转换为字符串，UTF-8编码格式下进行SHA-1计算后转换为16进制字节数组，用商户RSA私钥签名后转16进制。
数字信封
生成AES密钥，按照如下拼装：
格式：01|对称密钥，01代表AES算法
加密方式：Base64转码后使用科技服务方的公钥RSA加密
敏感字段加密
加密方式：Base64转码后，使用数字信封指定的方式和密钥加密
1.6.2 返回报文
返回报文格式
key1=value1&key2=value2&key3=value3…
验签算法
将科技服务方返回的除签名字段之外的不为空的字段按key-value的形式构建TreeMap<String, String>对象，按key1=value1&key2=value2…模式将TreeMap对象转换为字符串，UTF-8编码格式下进行SHA-1计算后转换为16进制字节数组。将科技服务方返回的签名字段转16进制字节数组，用科技服务方RSA公钥验签。
数字信封解密
解密方式：后使用商户的私钥解密后Base64解码
解密后格式：01|对称密钥，01代表AES算法
敏感字段解密
解密方式：使用数字信封指定的方式和密钥解密后Base64解码
最后编辑：庞寅 更新时间：2024-10-23 15:49
