查询订单¶
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 码。无论 PENDING、PAID、FAILED、CANCELLED、EXPIRED 等,成功查询均为 200,请读取 order.status 自行判断。
常见错误¶
| HTTP | 说明 |
|---|---|
401 |
鉴权失败 |
404 |
订单不存在、不属于当前商户,或误用了子单 ID |
429 |
限流 |