概述

本文档描述【PayEcho】聚合支付系统的接口对接方案。供内部相关开发和技术支持人员使用。 文档分别从通讯方式、签名、接口、注意事项等方面详细介绍了聚合扫码系统的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。

郑重申明

本文档中的所有内容为 【PayEcho】 的机密和专属所有。

未经 【PayEcho】 的明确书面许可，任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。

数据格式

API 接口使用 JSON 作为消息体的数据交换格式。
请求须设置 HTTP 头部（图片上传 API 除外）：

Content-Type: application/json
Accept: application/json

字符集

API 接口仅支持 UTF-8 字符编码的一个子集：使用一至三个字节编码的字符。也就是说，不支持 Unicode 辅助平面中的四至六字节编码的字符。

错误码和错误提示

当请求处理失败时，除了 HTTP 状态码表示错误之外，API 将在消息体返回错误相应说明具体的错误原因。

• code：详细错误码；
• message：错误描述，使用易理解的文字表示错误的原因；

User Agent

HTTP 协议要求发起请求的客户端在每一次请求中都使用 HTTP 头 User-Agent 来标识自己。建议调用方选用以下两种方式的一种：

• 使用 HTTP 客户端默认的 User-Agent。
• 遵循 HTTP 协议，使用自身系统和应用的名称和版本等信息，组成自己独有的 User-Agent。
• 支付 API 接口会拒绝处理无 User-Agent 的请求。