查詢訂單
按商戶訂單號查詢一筆入金或出金訂單。收到回調後用它複核,網路超時後也用它確認訂單有沒有建成。
POST
/api/open/order/getDetail完整地址 = 介面地址 + 這個路徑。介面地址在商戶後台「開發者 → API 與回調」檢視。
請求參數
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
merchantNo | string | 是 | 商戶號 |
merchantOrderNo | string | 是 | 你的商戶訂單號 |
只能查到自己商戶的訂單。先按入金單找,找不到再按出金單找。
回傳
| 欄位 | 類型 | 說明 |
|---|---|---|
orderState | int | 訂單狀態。入金見入金訂單狀態,出金見出金訂單狀態 |
orderStateText | string | 狀態說明(英文) |
amount | number | 法幣金額 |
currency | string | 法幣程式碼 |
paymentMethod | string | 收款方式,如 BankPay;入金單還沒分配收款帳戶時為空 |
payTime | string | 入金:客戶付款時間;出金:處理完成時間 |
releaseTime | string | 入金:平台釋放時間(出金沒有這個欄位) |
rate | number | 本單匯率 |
fees | number | 本單手續費(USDT) |
入金單和出金單的 orderState 含義不同,請按你自己記錄的訂單類型判斷。
json
{
"code": 0,
"message": "success",
"data": {
"orderState": 6,
"orderStateText": "Released",
"amount": 100,
"currency": "CNY",
"paymentMethod": "BankPay",
"payTime": "2026-10-13 12:00:00",
"releaseTime": "2026-10-13 12:03:10",
"rate": 7.3,
"fees": 0.41
}
}常見錯誤
| code | 說明 |
|---|---|
| 40000 | 沒傳商戶訂單號 |
| 40020 | 訂單不存在 |