基本规则

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

• 请求是否成功，与请求参数的顺序无关

• 请求是否成功，与请求JSON中的键值对出现的顺序无关

• 处理应答时，不应假设应答JSON中的键值对出现的顺序

• 新的API版本可能在请求或应答中加入新的参数或者JSON的键值对

• 新的API版本不会去除请求和应答中已经存在的必填参数或者JSON的键值对

• 当请求或应答中的JSON键值对的值为空（null）时，可以省略

1yyyy-MM-DDTHH:mm:ss.SSSZ
2yyyy-MM-DDTHH:mm:ssZ
3yyyy-MM-DDTHH:mm:ss.SSS+08:00
4yyyy-MM-DDTHH:mm:ss+08:00

• 处理成功的请求，如果有应答的消息体将返回200，若没有应答的消息体将返回204；

• 已经被成功接受待处理的请求，将返回202；

• 请求处理失败时，如缺少必要的入参、支付时余额不足，将会返回4xx范围内的错误码；

• 请求处理时发生了微信支付侧的服务系统错误，将返回500/501/503的状态码。这种情况比较少见。

• code：错误码，分为​​公共错误码​​和​​业务错误码​​，详见下方示例。

• message：错误描述，详细说明当前报错的具体原因，同一code（错误码）可能对应多个不同的message（错误描述）。

公共错误码

1//公共错误码返回示例
2{
3  "code": "SYSTEM_ERROR", 
4  "message": "系统异常，请稍后重试" 
5}

业务错误码（此处仅为示例，实际以API接口文档为准）

1//业务错误码返回示例
2{
3  "code": "NO_AUTH",
4  "message": "商户号该产品权限未开通，请前往商户平台>产品中心检查后重试"
5}

•  detail：错误的具体情况，当 code 为 PARAM_ERROR 或 INVALID_REQUEST 时返回。

  • field：指示错误参数的具体位置，当错误参数位于请求Body的JSON中，返回JSON Pointer路径 (如：/amount/currency)；当错误参数位于请求的 URL 或者 Query String 中，返回参数变量名(如：limit)；

  • value：错误的值；

  • issue：具体错误原因；

  • location：错误参数的来源位置，取值如下：

    • body：错误参数位于请求 Body 的 JSON 中；

    • url：错误参数位于请求 URL 中；

    • query：错误参数位于请求的 Query String 中；

1//detail返回示例
2{
3  "code": "PARAM_ERROR", 
4  "message": "参数错误", 
5  "detail": {
6    "field": "/amount/currency",
7    "value": "XYZ",
8    "issue": "Currency code is invalid",
9    "location" :"body"
10   }
11}

1. 使用HTTP客户端默认的User-Agent。

2. 遵循HTTP协议，使用自身系统和应用的名称和版本等信息，组成自己独有的User-Agent。

• en

• zh-CN

• zh-HK

• zh-TW