API 文档

# 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、查询余额 →