Skip to content

查询支付订单

TIP

除了我们的异步支付结果通知之外,你也可以通过此接口主动查询订单的支付结果。

请注意

IMPORTANT

创建订单接口返回并不代表发起或支付成功,如不清晰发起支付的状态和结果需要重试时,请 不要 更换业务流水号,一定要使用 原业务流水号 重试,否则可能 造成重复支付 等资金风险。同一个流水号只能上报一次,重复上报接口将提示外部订单号重复错误。

接口地址

order/query

请求参数

参数名称是否必须类型描述
outerTradeNotrueString外部订单号(您系统的订单号,保持唯一)

响应参数

返回订单模型,详情请查看 订单模型

响应成功状态

IMPORTANT

此接口正常请求查询返回,且明确订单状态为 SUCCESS 时,明确表示支付成功。 其他任何情况均不代表支付成功。

响应失败状态

订单创建失败

如果订单创建失败,将明确返回业务状态码 102003,此时请使用 原外部订单号 进行发起重试,避免出现 重复支付 等资金风险。

示例返回:

json
{
  "code": 102003,
  "message": "没有查询到指定的订单信息",
  "data": null
}

订单支付失败

IMPORTANT

此接口正常请求查询返回,且明确订单状态为 FAIL 时,明确表示支付失败。

已明确订单支付失败 ,此时请自行处理退款流程,并尝试使用新的外部订单号重新发起新的支付。