View Categories

查询静态代理交易详情

接口用途

此接口用于根据交易编号查询静态代理订单详情。它适用于核对购买或续费结果，并可返回交易涉及的节点、金额、数量和周期。

请求信息

GET /openapi/static/trade/detail

完整地址：

https://{domain}/openapi/static/trade/detail

请求时必须携带 user-id 和 access-key Header。

Query 参数

参数是否必填说明
trade_no是订单 ID

请求示例：

GET /openapi/static/trade/detail?trade_no={trade-no} HTTP/1.1
Host: {domain}
client-id: {your-user-id}
access-key: {your-access-key}

返回字段

字段说明
trade_no订单 ID
total_fee订单总金额
trade_time订单创建时间，Unix 时间戳（秒）
node_ids本次交易涉及的节点 ID 数组
node_qty节点数量
trade_mode交易类型：BUY 表示购买，EXTEND 表示续费
wallet_paid余额扣款金额
period_days购买或续费天数

此接口不返回 cashback_amount 字段。

成功响应示例

{
  "code": 0,
  "msg": "Ok",
  "info": {
    "trade_no": "aB3cD5eF",
    "total_fee": "29.90",
    "trade_time": 1754064000,
    "node_ids": ["xK9mP2nQ", "yL0nR3sT"],
    "node_qty": 2,
    "trade_mode": "BUY",
    "wallet_paid": "29.90",
    "period_days": 30
  }
}

常见问题

为什么返回订单不存在？

请确认 trade_no 完整且属于当前 API 凭证对应的账号。如果仍然返回 404 或 order does not exist，请记录订单 ID 和响应内容后联系 QuarkIP 支持团队。

如何区分购买订单和续费订单？

查看 trade_mode：BUY 表示购买，EXTEND 表示续费。