亮色模式
请求与响应结构
API - 消息结构
请求地址
| 属性 | 描述 | 示例 |
|---|---|---|
| URI-scheme | 表示用于传输请求的协议，当前所有 API 均采用 HTTPS 协议 | https:// |
| Endpoint | 指定支付环境（沙箱环境/生产环境）的服务器域名，对接时请按照环境选择对应域名 | celer-api.LianLianpay-inc.com/ |
| Resource-path | 资源路径，即 API 访问路径，从具体 API 的访问地址模块获取 | v3/merchants/202103310000636001/payments |
请求方法
| 方法 | 说明 |
|---|---|
| `GET` | 请求服务器返回指定资源 |
| `POST` | 请求服务器新增或更新资源 |
请求消息头
| 名称 | 描述 | 是否必填 | 示例 |
|---|---|---|---|
| signature | 签名 | 是 | ``` XJqQTCs1QTsp+xO3iWrEMhMZUF9Wt+s2XTilT48lyv3zCmJS1+twA9cYsq9Bg9hfTnOFziCaU0OD3ddYWTMRf13uyLjwwOKD6LWyBCd+17Fq4bBdFcCwiuA6ZUkXbIWKiLACf8gY0JkKpuEvXSSrvHcpS9MPakuXKKwOBRY1UXBhWr2bL3qr8r4bLUk1A35ZU7Oj5r2xZV3JrdeFYqBLss1jbXNT9bS4J5JFoFKw/xBzoBkYh7btm28b8i8Q5lY2Vu7vZVK+BGKfBff2PQOJ347VGyR3+ch4qrw0ABRC52jEycWWoGQbnzs6W8DwBGg64/aR7GpNz9sHIy6YW8KwZg== ``` |
| timezone | 时区 | 是 | Asia/Hong_Kong |
| timestamp | 格式化时间戳 | 是 | 20211022160000 格式为：yyyyMMddHHmmss |
| content-type | 媒体类型 | 是 | application/json |
:::info[]
说明：响应消息头的签名是由响应参数通过连连全球收单私钥加密后获得，商家拿到返回参数后，根据连连全球收单公钥和加密方式进行验签。
:::
响应消息体
| 名称 | 描述 | 是否必填 | 示例 |
|---|---|---|---|
| return_code | 业务返回code | 是 | SUCCESS |
| return_message | 业务提示信息 | 是 | Success |
| decline_code | 业务拒绝详情code | 否 | P910 |
| trace_id | 调用链 id，定位请求问题使用 | 是 | 14831.104.16405719130710367 |
| order | 业务响应参数 | 否 | 请参考API |
:::info[]
说明：以上响应消息体描述的返回参数为通用结构，每个接口的业务响应参数在 api 文档中具体说明，return_code返回SUCCESS时，业务响应参数 order 才有值；
:::
Notify - 消息结构
:::tip[]
- 开放消息会通过POST请求方式，主动调用商家提供的接收通知地址，给商家提供消息结果通知；
- 返回结果中 head 会加入验签参数，body 中返回业务参数；
:::
请求方法
| 方法 | 说明 |
|---|---|
| `POST` | 请求服务器新增或更新资源 |
请求消息头
| 名称 | 描述 | 是否必填 | 示例 |
|---|---|---|---|
| signature | 签名 | 是 | ``` XJqQTCs1QTsp+xO3iWrEMhMZUF9Wt+s2XTilT48lyv3zCmJS1+twA9cYsq9Bg9hfTnOFziCaU0OD3ddYWTMRf13uyLjwwOKD6LWyBCd+17Fq4bBdFcCwiuA6ZUkXbIWKiLACf8gY0JkKpuEvXSSrvHcpS9MPakuXKKwOBRY1UXBhWr2bL3qr8r4bLUk1A35ZU7Oj5r2xZV3JrdeFYqBLss1jbXNT9bS4J5JFoFKw/xBzoBkYh7btm28b8i8Q5lY2Vu7vZVK+BGKfBff2PQOJ347VGyR3+ch4qrw0ABRC52jEycWWoGQbnzs6W8DwBGg64/aR7GpNz9sHIy6YW8KwZg== ``` |
| timezone | 时区 | 是 | Asia/Hong_Kong |
| timestamp | 格式化时间戳 | 是 | 20211022160000 格式为：yyyyMMddHHmmss |
| sign-type | 加密方式 | 是 | RSA |
:::info[]
说明：响应消息头的签名是由响应参数通过连连全球收单私钥加密后获得，商家拿到返回参数后，根据连连全球收单公钥和加密方式进行验签。
:::
响应消息体
| 名称 | 描述 | 是否必填 | 示例 |
|---|---|---|---|
| code | 业务返回code | 是 | 200 |
| message | 业务提示信息 | 是 | success |
:::info[]
说明：以上响应消息体描述的返回参数为通用结构，必须返回此结果连连全球收单才会认为商家处理完毕，否则会重新投递消息通知。
:::