# 7、Hash 查詢訂單

請求方式

  • POST

請求 URL

/api/v3/wallet/query/ordertoHash

請求 Header

Content-Type: application/json;charset=utf-8

請求頭參數

參數名 類型 描述 範例值
access_key String 商戶後台獲取 pFqV75X3
timestamp int64 13位時間戳（毫秒） 1679724896223
nonce String 隨機字符串（UUID V4） 794c26b0-d33c-4394-b2bb-c485eca16d9e
sign String 使用金鑰生成的簽名 kAXyh+eerqrefyaF8dyFB0M4FVo=

請求參數（JSON）

{
  "tradeHash": "5e1fdbb146c02bf0042dae6e9e15c3fc556bddf93e63ab64f1b5b9a3c456813f",
  "startTime": "2024-03-31T16:00:00Z",
  "endTime": "2024-04-09T15:59:59Z"
}

參數說明

參數名 類型 描述 是否必填
tradeHash String 區塊鏈交易哈希值 ✅ 是
startTime String 查詢起始時間（UTC ISO8601） ✅ 是
endTime String 查詢結束時間（UTC ISO8601） ✅ 是

響應類型

Header: {
  "Content-Type": "application/json;charset=utf-8"
}

響應範例

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": [
    {
      "orderId": "OCRYPPAID202404080144071712540647531DEV001OO0000000400014827",
      "cashierId": "OCRYPPAID202404080144071712540647455DEV001OO0000000200014826",
      "orderType": 1,
      "orderResourceType": 1,
      "userId": "1707285840326127617",
      "orderStatus": 4,
      "orderTime": 1712540648000,
      "externalOrderId": "69511350",
      "orderAmount": "20",
      "orderActualAmount": "20",
      "orderEntryAmount": "6.9982",
      "orderFee": "13.0018",
      "orderPayTime": 1712540727000,
      "orderCompleteTime": 1712540727000,
      "currencyType": "USD",
      "tokenType": "USDT",
      "chainType": "TRON",
      "exchangeRate": "0.995",
      "addressFrom": "TNsGPpkaaMZX9GgUrk6FiGdAf94z9co2PA",
      "addressTo": "TGa3cWX6FzsJKKV9JYhFG5Q4NM2FwKuAWA",
      "tradeHash": "5e1fdbb146c02bf0042dae6e9e15c3fc556bddf93e63ab64f1b5b9a3c456813f",
      "orderTypeCode": "Pay",
      "orderResourceTypeCode": "Crypto",
      "orderStatusCode": "Completed"
    }
  ]
}

響應參數說明

參數名 類型 描述
orderId String 平台訂單ID
cashierId String 收銀台ID（可為空）
orderType int64 訂單類型（1-收款）
orderResourceType int64 所屬業務類型（1-加密訂單）
userId String 訂單發起人ID
orderStatus int64 訂單狀態碼
orderTime int64 訂單創建時間（Unix毫秒）
externalOrderId String 商戶訂單號
orderAmount String 訂單金額
orderActualAmount String 實際支付金額
orderEntryAmount String 商戶實際入賬金額
orderFee String 手續費金額
orderPayTime int64 支付時間（Unix毫秒）
orderCompleteTime int64 完成時間（Unix毫秒）
currencyType String 法幣類型（如 USD）
tokenType String 加密代幣類型（如 USDT）
chainType String 區塊鏈主鏈類型（如 TRON）
exchangeRate String 訂單生成時匯率
addressFrom String 出款地址
addressTo String 收款地址
tradeHash String 區塊鏈交易哈希
orderTypeCode String 訂單類型文本（如 Pay）
orderResourceTypeCode String 業務類型文本（如 Crypto）
orderStatusCode String 狀態描述（如 Completed）

← 8、查詢餘額 →