# 查詢訂單狀態 

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

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

使用 EPUSDT 的 `trade_id` 輪詢並更新收銀台。商戶應在非同步回呼驗章成功後出貨。

## 請求參數 

`trade_id` · `string` · PATH

建立訂單時回傳的 EPUSDT 交易編號。

## 訂單狀態 

| 值 | 說明                |
| - | ----------------- |
| 1 | 等待支付              |
| 2 | 支付成功              |
| 3 | 已過期               |
| 4 | 等待選擇支付網路/幣種       |
| 5 | 已發現匹配的鏈上轉賬，正在確認   |
| 6 | 兩輪嚴格核驗未通過，等待管理員複核 |

## 相關文件 

* [讀取收銀台訂單明細](https://epusdt.com/zh-tw/api/endpoints/checkout-details)
* [商戶回呼](https://epusdt.com/zh-tw/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"
}
```
