跳转到主要内容
  • 更新时间:2022-01-16 21:31:02

开放平台公共响应参数

参数类型名称示例值是否必须
codestring响应状态码.00000000必须
messagestring错误消息参数错误必须
traceIdstring请求消息唯一标识。traceId为本次调用产生的流水号,接口调用异常,可以提供此流水号用于排查问题。7457794513993866186必须
dataObject业务数据,为Json对象,如果请求错误,该字段可能会展示错误的详细信息。必须
data.statusstring订单状态(见补充说明)SUCCESS必须

补充说明

status表示订单状态,支付、退款和撤销的订单成功与否以status的值为准。
status有四种情况 PENDING、SUCCESS、FAILED、CLOSED,分别表示 处理中、成功、失败、订单关闭。

响应格式

所有接口响应Content-Type均为:application/json,即响应均为json格式。接口响应有统一的格式:

成功格式

{
  "code": "00000000",
  "message": "SUCCESS",

  "traceId": "cfef69feec8d25aa",
  "data": 
    {
      "status": "SUCCESS"
    }
}
  1. 主动扫码支付是异步的,code为00000003表示业务请求成功待用户支付,该笔订单显示为”PENDING”状态,用户支付结果可以通过手动查询交易订单获取。
  2. 微信中的被扫支付(MICROPAY),若用户支付成功,则直接返回状态”SUCCESS”。若遇到网络异常或者用户支付时间过长等,则返回状态为”PENDING”,可以通过查询接口查询交易结果。
  3. 接口请求成功时data字段表示接口响应的业务数据。

失败格式

{
  "code": "22070030",
  "message": "Format error-transType cannot be empty",
  "traceId": "174d6e0d78675e0c",
  "data": {
      "status": "FAILED"
  }
}
  • code定义参见4,错误码定义。message字段为错误描述信息。
  • traceId为本次调用产生的流水号,接口调用异常,可以提供此流水号用于排查问题。

常见错误FAQ

问题回复
请求提醒缺少系统参数。检查系统参数是否正确。对于Post请求所有参数都放在Body里!不可以放在Query里。