Skip to content

查詢訂單 ​

按商戶訂單號查詢一筆入金或出金訂單。收到回調後用它複核,網路超時後也用它確認訂單有沒有建成。

POST/api/open/order/getDetail

完整地址 = 介面地址 + 這個路徑。介面地址在商戶後台「開發者 → API 與回調」檢視。

請求參數 ​

參數類型必填說明
merchantNostring是商戶號
merchantOrderNostring是你的商戶訂單號

只能查到自己商戶的訂單。先按入金單找,找不到再按出金單找。

回傳 ​

欄位類型說明
orderStateint訂單狀態。入金見入金訂單狀態,出金見出金訂單狀態
orderStateTextstring狀態說明(英文)
amountnumber法幣金額
currencystring法幣程式碼
paymentMethodstring收款方式,如 BankPay;入金單還沒分配收款帳戶時為空
payTimestring入金:客戶付款時間;出金:處理完成時間
releaseTimestring入金:平台釋放時間(出金沒有這個欄位)
ratenumber本單匯率
feesnumber本單手續費(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.orderNostring平台訂單號(CD 開頭)
crypto.payAddressstring本單收款地址
crypto.payNetworkstringTRC20 / BEP20
crypto.payCoinstringUSDT / USDC
crypto.payAmountnumber應付幣數量
crypto.receivedAmountnumber累計到帳的幣數量
crypto.creditedAmountnumber累計記入你餘額的 USDT(扣手續費前)
crypto.txHashstring第一筆到帳的交易哈希
crypto.underpaid / crypto.overpaidbool少付 / 多付
crypto.expireAtstring付款截止時間,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訂單不存在