查詢訂單
按商戶訂單號查詢一筆入金或出金訂單。收到回調後用它複核,網路超時後也用它確認訂單有沒有建成。
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
}
}加密貨幣充值訂單
加密貨幣充值訂單也用這個介面查(先查入金訂單,查不到再查加密貨幣訂單)。上面的欄位照樣回傳:amount、currency 是下單時傳的金額和幣種,paymentMethod 是 USDT-TRC20 這種寫法,payTime / releaseTime 是第一次入帳時間,fees 是累計手續費。另外多一個 crypto 物件:
| 欄位 | 類型 | 說明 |
|---|---|---|
crypto.orderNo | string | 平台訂單號(CD 開頭) |
crypto.payAddress | string | 本單收款地址 |
crypto.payNetwork | string | TRC20 / BEP20 |
crypto.payCoin | string | USDT / USDC |
crypto.payAmount | number | 應付幣數量 |
crypto.receivedAmount | number | 累計到帳的幣數量 |
crypto.creditedAmount | number | 累計記入你餘額的 USDT(扣手續費前) |
crypto.txHash | string | 第一筆到帳的交易哈希 |
crypto.underpaid / crypto.overpaid | bool | 少付 / 多付 |
crypto.expireAt | string | 付款截止時間,UTC+8 |
json
{
"code": 0,
"message": "success",
"data": {
"orderState": 6,
"orderStateText": "Released",
"amount": 200,
"currency": "USDT",
"paymentMethod": "USDT-TRC20",
"payTime": "2026-10-21 12:05:40",
"releaseTime": "2026-10-21 12:05:40",
"rate": null,
"fees": 2,
"crypto": {
"orderNo": "CD20261021120000123456",
"payAddress": "T…",
"payNetwork": "TRC20",
"payCoin": "USDT",
"payAmount": 200,
"receivedAmount": 200,
"creditedAmount": 200,
"txHash": "…",
"underpaid": false,
"overpaid": false,
"expireAt": "2026-10-21 13:00:00"
}
}
}常見錯誤
| code | 說明 |
|---|---|
| 40000 | 沒傳商戶訂單號 |
| 40020 | 訂單不存在 |