Appearance
查询支付订单
TIP
除了我们的异步支付结果通知之外,你也可以通过此接口主动查询订单的支付结果。
请注意
IMPORTANT
创建订单接口返回并不代表发起或支付成功,如不清晰发起支付的状态和结果需要重试时,请 不要 更换业务流水号,一定要使用 原业务流水号 重试,否则可能 造成重复支付 等资金风险。同一个流水号只能上报一次,重复上报接口将提示外部订单号重复错误。
接口地址
order/query
请求参数
| 参数名称 | 是否必须 | 类型 | 描述 |
|---|---|---|---|
| outerTradeNo | true | String | 外部订单号(您系统的订单号,保持唯一) |
响应参数
返回订单模型,详情请查看 订单模型
响应成功状态
IMPORTANT
此接口正常请求查询返回,且明确订单状态为 SUCCESS 时,明确表示支付成功。 其他任何情况均不代表支付成功。
响应失败状态
订单创建失败
如果订单创建失败,将明确返回业务状态码 102003,此时请使用 原外部订单号 进行发起重试,避免出现 重复支付 等资金风险。
示例返回:
json
{
"code": 102003,
"message": "没有查询到指定的订单信息",
"data": null
}订单支付失败
IMPORTANT
此接口正常请求查询返回,且明确订单状态为 FAIL 时,明确表示支付失败。
如 已明确订单支付失败 ,此时请自行处理退款流程,并尝试使用新的外部订单号重新发起新的支付。
