# 3、查詢訂單

# 查詢收款訂單

請求方式

  • POST

請求 URL

/api/v3/wallet/query/pay

請求 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）

{
  "externalOrderId": "402297358314559082",
  "orderId": "OCRYPPAID202307310902391690794159441DOCKER020000000400001108"
}

參數說明

參數名 類型 描述 是否必填
externalOrderId String 商戶訂單號 是
orderId String 平台生成的訂單號 是

響應類型

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

響應範例

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": [{
    "orderId": "OCRYPPAID202307310902391690794159441DOCKER020000000400001108",
    "cashierId": "OCRYPPAID202307310902391690794159250DOCKER020000000200001107",
    "orderType": 1,
    "orderResourceType": 1,
    "userId": "1663371399710216194",
    "orderStatus": 1,
    "orderTime": 1690794159000,
    "externalOrderId": "402297358314559082",
    "orderAmount": "1",
    "currencyType": "USD",
    "tokenType": "USDT",
    "chainType": "ETH",
    "exchangeRate": "0.983",
    "addressTo": "0xe072c63c1e04f8c6f36133f6629f66778147d5d8",
    "orderTypeCode": "Pay",
    "orderResourceTypeCode": "Crypto",
    "orderStatusCode": "Wait pay"
  }]
}

響應參數說明

參數名 類型 描述
orderId String 平台訂單號
cashierId String 收銀台 ID
orderType int64 訂單類型，枚舉值：1 1-收款
orderTypeCode String 訂單類型文字描述
orderResourceType int64 所屬業務類型，枚舉值：1 1- 加密訂單
orderResourceTypeCode String 業務類型文字描述
userId String 發起訂單的用戶 ID
orderTime int64 訂單創建時間（時間戳）
externalOrderId String 商戶訂單號
orderAmount String 訂單金額
currencyType String 法幣類型（如 USD）
tokenType String 加密幣種（如 USDT）
chainType String 加密主鏈類型（如 ETH）
exchangeRate String 創建訂單時的匯率
addressTo String 支付地址（平台生成的收款地址）
orderStatusCode String 狀態碼描述
orderStatus int64 狀態碼，枚舉值：1、2、4、8、16 詳細說明請參考下方訂單狀態碼說明

訂單狀態碼說明

狀態碼 狀態描述 是否終態 說明
1 待支付 否 訂單已創建，用戶尚未付款；無需處理
2 鏈上確認中 否 用戶在收銀台點擊“已完成支付”，系統正在檢測鏈上是否到賬；無需處理
4 已完成 是 支付成功，系統會觸發回調；商戶需根據業務邏輯增加餘額或完成發貨等操作
8 支付金額不匹配 是 用戶支付金額 ≠ 應付金額，系統會觸發回調；建議按實際支付金額入賬
16 超時收款 是 用戶支付超時，系統不會再回調；商戶如確認收款到賬需手動處理
32 未支付（地址釋放） 是 用戶長時間未支付，地址釋放；若後續支付將生成新訂單

# 查詢代付訂單

請求方式

  • POST

請求 URL

/api/v3/wallet/query/transfer

請求 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）

{
  "externalOrderId": "622257420681202921",
  "orderId": "OCRYPDRAW202307310902401690794160841DOCKER020000000200001109"
}

參數說明

參數名 類型 描述 是否必填
externalOrderId String(64) 商戶訂單號 是
orderId String 平台生成的訂單號 是

響應類型

Header:

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

響應範例

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": [{
    "orderId": "OCRYPDRAW202307310902401690794160841DOCKER020000000200001109",
    "cashierId": "",
    "orderType": 2,
    "orderResourceType": 1,
    "userId": "1663371399710216194",
    "orderStatus": 1,
    "orderTime": 1690794160000,
    "externalOrderId": "622257420681202921",
    "orderAmount": "1",
    "orderActualAmount": "1.01",
    "orderFee": "0.01",
    "currencyType": "USD",
    "tokenType": "USDT",
    "chainType": "ETH",
    "exchangeRate": "0.983",
    "addressTo": "0xa8666442fA7583F783a169CC9F5449ec660295E8",
    "tradeHash": "0xe9d043c9cbdb96ed7a71c5a0923baabe9e23316b3f1b0a01975bcd6d69b41fa3",
    "orderTypeCode": "Transfer",
    "orderResourceTypeCode": "Crypto",
    "orderStatusCode": "Accepted"
  }]
}

響應參數說明

參數名 類型 描述
orderId String 平台訂單號
orderType int64 訂單類型（2 = 代付）
orderResourceType int64 所屬業務類型（1 = 加密訂單）
userId String 發起訂單的用戶 ID
orderTime int64 訂單創建時間（毫秒時間戳）
externalOrderId String 商戶自定義訂單號
orderAmount String 訂單金額（商戶預設）
orderActualAmount String 實際扣除金額（包含手續費）
orderFee String 平台手續費金額
currencyType String 法幣類型（如 USD）
tokenType String 加密幣種（如 USDT）
chainType String 鏈類型（如 ETH、TRON、BSC）
exchangeRate String 匯率（生成訂單時使用）
addressTo String 轉賬目標地址（用戶錢包地址）
tradeHash String 區塊鏈交易哈希值（鏈上可查）
orderTypeCode String 訂單類型描述（如 Transfer）
orderResourceTypeCode String 所屬業務類型描述（如 Crypto）
orderStatusCode String 狀態碼文字描述（如 Accepted）
orderStatus int64 訂單狀態碼，詳見下方【狀態碼定義】

orderStatus 狀態碼定義

狀態碼 描述 是否終態 說明
1 已受理 否 訂單已提交，等待鏈上執行
2 已完成 是 轉賬成功，鏈上已確認，可透過 hash 查看
4 出款失敗 是 轉賬失敗，平台將不再重試
8 待審批 否 風控/權限原因等待人工審核
16 拒絕出款 是 審核被拒，訂單取消

← 4、查詢餘額 →