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