通用约定
Base URL（示例）
https://api.baofu.com实际前缀以环境配置为准；下列路径均为在网关之后的 相对路径。
Header HTTP头参数
详细请参考【开发指引-整体说明】
| Header | 必填 | 说明 |
|---|---|---|
Authorization |
是 | 统一网关鉴权；签名算法与签名参数见下表（须在一行内，勿换行） |
Content-Type |
是 | 固定 application/json |
宝付要求请求通过HTTP Authorization头来传递签名。Authorization由认证类型和签名信息两个部分组成。
Authorization: 认证类型 签名信息
具体组成为：
- 认证类型，取值 RSA/SM2
签名信息
| 参数名 | 说明 |
|---|---|
| mch_id | 宝付分配的唯一商编 |
| app_id | 宝付终端号，选填，若传值，则使用宝付4.0证书 |
| nonce_str | 请求随机串,和上面构造签名串的随机串要保持一致 |
| timestamp | 时间戳 和上面构造签名串的时间戳要保持一致 |
| serial_no | 商户API证书序列号，用于声明所使用的证书 |
| baofu_serial_no | 宝付证书序列号, 联系技术支持提供 |
| dgtl_envlp | 数字信封(非必填),16位密钥,用宝付公钥加密后传输 |
| signature | 签名值，上面算出来的签名值 |
注意：以上七项签名信息，无顺序要求。数字信封参数可以为空
Authorization头的示例如下：（注意，示例因为排版可能存在换行，实际数据应在一行）
Authorization: RSA mch_id="128308",app_id="128308",nonce_str="P7X2R9Z1M5W6Q4V3B8C0D2E1F7G9H2J4",signature="DKLJASKLFGHQWJFPWQJLFKGDKSLGJPQJPFWQJLGKNDLSKJGLDSJLKFSJAKL",timestamp="1507488238",serial_no="123821002",baofu_serial_no="123822342",dgtl_envlp="GLKUIOWQGKDLSNGLKQWJPRQ"Body 原则
- 业务参数使用 驼峰 命名。
- 统一会员标识、证书序列号、签名类型等已在网关 Header 中体现时，不要在 Body 重复传同名敏感元数据（与网关规范一致）。
统一响应
统一网关返回口径：
- 成功：仅返回业务
data内容本身 - 失败：仅返回
code与message
成功示例：
{
"subscription_no": "SP01010120260319120000000001",
"subscription_status": "ACTIVE"
}失败示例：
{
"code": "USER_PAYING",
"message": "绑卡处理中"
}字段说明（失败场景）：
| 字段 | 说明 |
|---|---|
code |
错误码 |
message |
错误说明 |
###
