API Document

# 7、Hash Query Order

Request Method

  • POST

Request URL

/api/v3/wallet/query/ordertoHash

Request Header

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

Request Header Parameters

Parameter Name Type Description Example Value
access_key String Merchant backend access key pFqV75X3
timestamp int64 13-digit timestamp (milliseconds) 1679724896223
nonce String Random string (UUID V4) 794c26b0-d33c-4394-b2bb-c485eca16d9e
sign String Signature generated using a secret key kAXyh+eerqrefyaF8dyFB0M4FVo=

Request Parameters (JSON)

{
  "tradeHash": "5e1fdbb146c02bf0042dae6e9e15c3fc556bddf93e63ab64f1b5b9a3c456813f",
  "startTime": "2024-03-31T16:00:00Z",
  "endTime": "2024-04-09T15:59:59Z"
}
Parameter Name Type Description Required
tradeHash String Blockchain transaction hash ✅ Yes
startTime String Start time (UTC ISO8601) ✅ Yes
endTime String End time (UTC ISO8601) ✅ Yes✅ 是

Response Type

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

Response Example

{
  "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"
    }
  ]
}

Response Parameters Description

Parameter Name Type Description
orderId String Platform order ID
cashierId String Cashier ID (can be empty)
orderType int64 Order type (1 - Payment)
orderResourceType int64 Business type (1 - Crypto Order)
userId String Order initiator's user ID
orderStatus int64 Order status code
orderTime int64 Order creation time (Unix milliseconds)
externalOrderId String Merchant order ID
orderAmount String Order amount
orderActualAmount String Actual payment amount
orderEntryAmount String Actual merchant entry amount
orderFee String Transaction fee
orderPayTime int64 Payment time (Unix milliseconds)
orderCompleteTime int64 Completion time (Unix milliseconds)
currencyType String Fiat currency type (e.g., USD)
tokenType String Crypto token type (e.g., USDT)
chainType String Blockchain type (e.g., TRON)
exchangeRate String Exchange rate at order creation
addressFrom String Withdrawal address
addressTo String Receiving address
tradeHash String Blockchain transaction hash
orderTypeCode String Order type description (e.g., Pay)
orderResourceTypeCode String Business type description (e.g., Crypto)
orderStatusCode String Status description (e.g., Completed)

← 8、Query Balance →