User Tickets (user-ticket)

UserTicketEventProps

Evento retornado dentro de um user ticket (com canal). Usado em ticket.event. Em orders.get o channel pode vir sem name; em events.getUserEventTickets inclui name.

type UserTicketEventProps = Pick<
  EventProps,
  'id' | 'name' | 'slug' | 'startsAt' | 'opensAt' | 'timezone' | 'address' | 'image'
> & {
  channel: Pick<ChannelProps, 'id' | 'slug'> & { name?: string };
};

UserTicketItemTicketProps

Ingresso/produto retornado dentro de um user ticket. Subconjunto de TicketProps: type, name, transferable, image, group (sem id no ticket em getUserEventTickets) e event: UserTicketEventProps.

type UserTicketItemTicketProps = Pick<
  TicketProps,
  'type' | 'name' | 'transferable' | 'image' | 'group'
> & {
  beginsAt?: string | null;
  event: UserTicketEventProps;
};

UserTicketProps

Representa um ingresso do usuário, já associado a um evento e canal (ex.: retorno de sdk.events.getUserEventTickets).

type UserTicketProps = {
  id: string;
  slug: string;
  qrCodeDataUrl: string;
  ticket: UserTicketItemTicketProps;
  nomination?: Pick<NominationProps, 'name' | 'document'> | null;
  seatId?: string | null;
  usedAt?: string | null;
  isInvite?: boolean;
  ownerEmail?: string;
};

Campos principais:

• id / slug – Identificador único e slug do ingresso do usuário.
• qrCodeDataUrl – QRCode em formato data URL (para exibir/gerar PDF).
• ticket – Ingresso com dados do evento e canal (ver UserTicketItemTicketProps); ticket.event inclui channel (id, slug, name) e dados do evento.
• nomination? – Dados do portador (nome, documento) quando o ingresso é nominável; pode ser null.
• seatId? – Assento associado, se houver; pode ser null.
• usedAt? – Data/hora de uso do ingresso.
• isInvite? – Indica se é convite/cortesia (quando retornado pela API).
• ownerEmail? – E‑mail do dono do ingresso (quando retornado pela API).