接口调用规则【必读】

• 更新时间：2022-01-16 21:31:02

​

修订记录

​

请求说明

​

参数说明

​

系统参数

​

业务参数

• 查看API列表中具体的参数。

​

注意：

1. 对于POST请求，请求参数全部放在Body里，不要把参数放在Query里。
2. 对于POST请求，请求参数全部放在Body里，不要把参数放在Query里。
3. 对于POST请求，请求参数全部放在Body里，不要把参数放在Query里。

​

响应格式

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

​

成功格式

{
  "isSuccess": true,
  "errCode": "00000003",
  "errMessage": "Pending",
  "status": "PENDING",
  "traceId": "cfef69feec8d25aa",
  "data": null
}

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

​

失败格式

{
  "isSuccess": false,
  "errCode": "22070030",
  "errMessage": "Format error-transType cannot be empty",
  "status": "FAIL",
  "traceId": "174d6e0d78675e0c",
  "data": null
}

• errCode定义参见4，错误码定义。errMessage字段为错误描述信息。
• traceId为本次调用产生的流水号，接口调用异常，可以提供此流水号用于排查问题。

​

交易类型列表

​

常见错误FAQ