查询订单
查询支付订单的当前状态及相关记录。这些接口使用请求体 accessSign 认证。
查询订单状态
接口
POST /v4.0.0/api/orders/query请求
json
{
"payOrderId" : "01KWCGJ...3CTF04A",
"merchantOrderId" : "1234....",
"accessSign" : "BE3...79E"
}| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
accessKeyId | string | 是 | 您的商户 Access Key ID |
merchantOrderId | string | 是 | 您的唯一订单标识符 |
accessSign | string | 是 | 请求体的 HMAC-SHA256 签名（不包含 accessSign 本身） |
响应
json
{
"code" : 0,
"msg" : "success",
"ui" : null,
"version" : null,
"count" : 0,
"data" : {
"merchantAddress" : "TC8HbWAhV1q797DzNG6qffAHeuGMxbUzPi",
"merchantChannel" : "default",
"chain" : "TRON",
"blockChain" : "TRON",
"tokenSymbol" : "usdt",
"createChannel" : 1,
"accessChannel" : 0,
"merchantOrderId" : "8b7eb554-b847-4450-9",
"payOrderId" : "01KWCGJ443GX4SCBQK53CTF04A",
"tokenAddress" : "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"receiptAddress" : "TX5PLEFrEdBETP3Xp3DBcTCt58FNuDGL8h",
"amount" : 0.01,
"state" : 0,
"accessSign" : "BE333D8F1A561EFFCA7C0DCB88BC60C1EE67A00E6FBE02333270B8C68564679E",
"confirmCount" : "0",
"walletConnectEnable" : false,
"bridgeServerAddress" : "https://bridge.hashnut.io",
"eip712ChainId" : "0",
"chainId" : "0",
"createTime" : 1782831452288,
"rate" : 80,
"obtainAmount" : 0.00992,
"platformFee" : 8.0E-5,
"expireDuration" : "600",
"payWebType" : 0,
"flagAmount" : 0,
"underPaid" : false,
"paidAmount" : 0,
"supplementCount" : 0,
"custodyMode" : 4,
"supplements" : [ ]
}
}| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 0 表示成功，非零表示错误 |
msg | string | 可读的消息文本 |
data.payOrderId | string | HashNut 生成的订单 ID |
data.merchantOrderId | string | 您的原始订单 ID |
data.tokenAddress | string | 支付token的合约地址 |
data.receiptAddress | string | 客户付款的区块链收款地址 |
data.blockChain | string | 区块链名称（如 ETH、TRON、BSC、POLYGON） |
data.tokenSymbol | string | 代币符号（如 usdt、usdc） |
data.amount | string | 支付金额 |
data.state | integer | 订单状态（0 = INIT）。参见订单状态 |
data.expireDuration | string | 过期时间 |
TIP
使用"查询订单"检查订单状态。当您需要详细的链上信息（如区块号和确认数）时，使用"查询支付交易"。