Order 对象

订单及其门票。

创建订单和获取订单返回的对象。

一笔订单是一位买家为一个活动购买的门票,使用销售方自己的订单号创建。活动归档后订单仍可读取。

字段

orderIdstring

销售方的订单号,即创建订单时发送的订单号。只在该销售方 ID 内唯一。

eventIdstring

门票所属的活动。

createdAtstring

订单创建时间。

updatedAtstring

订单最后一次发生变化的时间:扫码、作废、工作人员编辑或邮件发出。比较它即可判断是否需要重新查看。

buyerobject

购票人。

›展开属性
namestring

姓名,即发送时的值,除非工作人员之后修改过。

emailstring

邮箱,已转为小写;未发送则为 ""。

emailStatusstring

我们是否已把门票通过邮件发给买家。订单没有要求时(没有 sendEmail: true)为 not-requested;否则为 sent、queued(超出每日额度,会在额度空出时发出)、unsent(未发出:工作人员可在管理后台发送)或 unconfirmed(仍在发送中,或可能已发出也可能没有:工作人员会先核实再重发)。见发送门票邮件。

ticketCountnumber

订单包含的门票数量,包括已作废的。

ticketsTicket[]

门票,按票种分组,顺序为:normal、early-bird、student、early-bird-student、vip。见 Ticket 对象。

Ticket 对象

ticketIdstring

门票 ID,一个 UUID。

typestring

票种:可售票种之一(normal、early-bird、student、early-bird-student、vip)。工作人员可以在管理后台把门票改为官网的任意票种,其中还包括 Comp Ticket、guest 和 vendor。

qrstring

作为门票二维码展示的内容,请原样使用。它是给工作人员用的链接:入口扫码器读取它,已登录的工作人员打开它即可放行该门票。它不是给买家看的页面。

statusstring

valid、used 或 voided,是下面各标志的汇总:先扫码后作废的门票为 voided。

createdAtstring

门票签发时间。

redeemedboolean

是否已在入口扫码。工作人员可以撤销扫码,此时它会变回 false。

redeemedAtstring | null

扫码时间,或 null。

voidedboolean

是否已被工作人员作废,例如因为退款。已作废的门票不能入场。

示例

活动当晚的一笔订单,第一张门票已在入口扫码:

{
  "orderId": "WX20261028123456",
  "eventId": "k3Xq9VbLm2PzR8TaYw4N",
  "createdAt": "2026-10-28T09:12:44.311Z",
  "updatedAt": "2026-11-14T18:31:02.907Z",
  "buyer": {
    "name": "李明",
    "email": "liming@qq.com"
  },
  "emailStatus": "sent",
  "ticketCount": 2,
  "tickets": [
    {
      "ticketId": "3f0c1e9a-5b7d-4c2e-9a41-7d8e2b6f1c05",
      "type": "normal",
      "qr": "https://sekaibeyond.com/claim?ticket=3f0c1e9a-5b7d-4c2e-9a41-7d8e2b6f1c05&event=k3Xq9VbLm2PzR8TaYw4N",
      "status": "used",
      "createdAt": "2026-10-28T09:12:44.311Z",
      "redeemed": true,
      "redeemedAt": "2026-11-14T18:31:02.907Z",
      "voided": false
    },
    {
      "ticketId": "b81d4f62-0e3a-4a9c-8f17-2c5b9e7d3a10",
      "type": "student",
      "qr": "https://sekaibeyond.com/claim?ticket=b81d4f62-0e3a-4a9c-8f17-2c5b9e7d3a10&event=k3Xq9VbLm2PzR8TaYw4N",
      "status": "valid",
      "createdAt": "2026-10-28T09:12:44.311Z",
      "redeemed": false,
      "redeemedAt": null,
      "voided": false
    }
  ]
}

本页目录