查询订单

GET /api/orders/:orderNo（公开）

前端用于让客户查自己的订单状态，只能查当前域名的订单。

请求头

头	必填	说明
x-domain	✅	站点域名

响应

{
  "success": true,
  "data": {
    "orderNo": "MO2RC2QC-V2G",
    "status": "paid",
    "product": "Gateway Integration",
    "amount": 4500000,
    "currency": "PKR",
    "createdAt": "2026-04-17T10:20:31.572Z"
  }
}

---

GET /api/orders（JWT，管理员）

订单列表，支持分页和过滤。

Query 参数

参数	类型	说明
domain	string	过滤域名，留空查全部
status	string	pending | paid | cancelled
from	ISO 8601	开始时间
to	ISO 8601	结束时间
page	number	默认 1
pageSize	number	默认 20，最大 100

响应

{
  "success": true,
  "items": [ /* OrderRecord[] */ ],
  "total": 42,
  "page": 1,
  "pageSize": 20
}

---

GET /api/orders/detail/:orderNo（JWT，管理员）

按订单号查完整详情，不限域名，返回含支付网关全量字段。

curl https://api.techconsult.site/api/orders/detail/MO2RC2QC-V2G \
  -H "Authorization: Bearer <token>"

响应（含完整 payment 字段）

{
  "success": true,
  "data": {
    "orderNo": "MO2RC2QC-V2G",
    "domain": "technologyconsult.org",
    "status": "paid",
    "payment": {
      "provider": "jazzcash",
      "status": "completed",
      "txnRefNo": "T202604171520310IVN5",
      "retrievalReferenceNo": "202604171520335572778327",
      "authCode": "AG_20260417_102034359",
      "responseCode": "000",
      "gatewayStatus": "Completed",
      "verified": true
    }
  }
}