# 查询订单状态 

**GET**`https://pay.example.com/pay/check-status/{trade_id}`

[请求示例 ↓](https://epusdt.com/zh/api/endpoints/order-status#request-example)

使用 EPUSDT 的 `trade_id` 轮询并更新收银台。商户应在异步回调验签成功后发货。

## 请求参数 

`trade_id` · `string` · PATH

创建订单时返回的 EPUSDT 交易号。

## 订单状态 

| 值 | 说明                |
| - | ----------------- |
| 1 | 等待支付              |
| 2 | 支付成功              |
| 3 | 已过期               |
| 4 | 等待选择支付网络/币种       |
| 5 | 已发现匹配的链上转账，正在确认   |
| 6 | 两轮严格核验未通过，等待管理员复核 |

## 相关文档 

* [读取收银台订单详情](https://epusdt.com/zh/api/endpoints/checkout-details)
* [商户回调](https://epusdt.com/zh/api/payment#callbacks)

## 响应

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` object  
接口返回的数据，失败时为 null。

  * `trade_id` string
  * `status` integer
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

[error-codes.json ↓](https://epusdt.com/agent-setup/error-codes.json)

**请求示例**

网关地址 trade\_id 

```
curl -i -X GET \
  'https://pay.example.com/pay/check-status/20260523171652123456001'
```

输入自己的网关地址即可试调公开查询接口。

**响应示例**200 · 成功400 · 10008 · 订单不存在

application/json · 响应字段节选

```
{
  "status_code": 200,
  "message": "success",
  "data": {
    "trade_id": "20260523171652123456001",
    "status": 1
  },
  "request_id": "b1344d70-ff19-4543-b601-37abfb3b3686"
}
```
