跳转至

查询订单

GET {BASE_URL}/api/v1/open/charges/{orderId}

  • orderId:建单返回的 order.id(UUID)
  • 请勿使用收银台「转 USDT」产生的内部子单 ID 查询(将返回 404

请求头

必填 说明
Authorization Bearer + 完整 API 密钥

成功响应 200

{
  "order": { "... 与创建接口的 order 字段相同 ..." },
  "payment_url": "https://..."
}

状态如何判断

接口不按状态返回不同 HTTP 码。无论 PENDINGPAIDFAILEDCANCELLEDEXPIRED 等,成功查询均为 200,请读取 order.status 自行判断。

常见错误

HTTP 说明
401 鉴权失败
404 订单不存在、不属于当前商户,或误用了子单 ID
429 限流