Eventos e ingressos

Para quem: produtor, organizador, gerente

Última revisão: 2026-07-13

Rotas relacionadas: /seller/events, /seller/new-event, /seller/events/[id]/edit, /seller/events/[id]

O que você consegue fazer

Criar eventos com uma ou várias datas (sessões)

Configurar lotes de ingressos com preços e quantidades

Controlar vendas (abertas, pausadas, encerradas)

Gerenciar fila de espera em tempo real

Emitir cupons, cortesias e certificados de participação

Pré-requisitos

Organização criada e vinculada ao seu usuário

Stripe Connect ativo com saques habilitados (payoutsEnabled) — sem isso, o botão + evento em /seller/events não aparece

Role com permissão para criar eventos (organizer, manager ou admin)

Detalhes de pagamentos: Stripe e taxas.

Passo a passo — Criar evento

1. Abrir o formulário

Acesse /seller/new-event ou clique em + evento em /seller/events.

2. Preencher informações básicas

Campo	Obrigatório	Observação
Nome do evento	Sim	Mínimo 1 caractere
Organização	Sim	Só na criação; evento fica vinculado ao dono da org
Descrição	Sim	Texto público do evento
Localização	Sim	Endereço + coordenadas via Google Places
Data principal	Sim	Deve ser hoje ou data futura
Horário início / término	Sim	Formato de hora
Capa	Não	Imagem opcional (comprimida)
Categoria (tag)	Não	theater, dance, music, exhibition, cinema, circus, party, class, gastronomy, fashion

3. Datas adicionais (múltiplas sessões)

Use + adicionar outra data para eventos com mais de um dia. Cada data vira uma sessão (eventSessions) com lotes próprios.

Atenção: confirme a data principal antes de salvar. Se você só adicionar datas extras sem editar a data principal (que vem preenchida com hoje por padrão), o formulário bloqueia o envio com a mensagem *"Confirme a data principal do evento"*.

4. Configurar lotes

Se o evento vende ingressos (opção Não ofertar tickets desmarcada):

Cada data tem abas de lotes

Por lote: nome, preço (R$), quantidade, info opcional (ex.: elegibilidade para meia)

Use + adicionar lote para criar lotes extras (ilimitados)

A soma de todas as quantidades deve ser maior que zero

5. Opções de venda

Opção	Efeito
Evento privado	Não aparece na home nem na página da org; acesso só por link
Começar com vendas abertas / pausadas	`salesStatus: open` ou `paused` na criação
Meia entrada disponível	Habilita tipo meia na compra
Certificado de participação	Se ativo, título do certificado é obrigatório
Não ofertar tickets	Evento sem venda; lotes não são exigidos

6. Publicar

Ao salvar, o sistema:

Gera slug único (org-nome-evento-####)

Gera senha de validação (12 caracteres) para check-in

Cria sessões e lotes no Convex

Redireciona para a página pública /event/{slug}

Arquitetura de ingressos


events (evento pai)

  └── eventSessions (uma por data)

        └── ticketBatches (lotes ilimitados por sessão)

Cada lote tem: name, price, totalTickets, soldTickets, isActive, salesStart, salesEnd.

Passo a passo — Gerenciar evento

Em /seller/events, expanda o card do evento. Para um guia visual completo do card (como chegar, expandir, cada botão e seção), veja 06 — Gestão de eventos no painel.

Resumo das ações no card:

Ação	Rota / componente
Editar	`/seller/events/{id}/edit`
Dashboard de vendas	`/seller/events/{slug ou id}`
Validar tickets	`/seller/validate-ticket/{password}`
Status de vendas	Abrir / pausar / encerrar
Virar lote	Encerra lote atual (`isActive: false`)
Cupons	Gerar códigos de desconto
Cortesias	Links de convite gratuitos
Cancelar evento	Dispara fluxo de cancelamento e reembolsos
Bar digital	Ativar módulo de consumo no evento

Edição de ingressos

Ao editar em /seller/events/[id]/edit:

Ingressos já vendidos continuam válidos

Você pode aumentar a quantidade de um lote

Não reduza abaixo do que já foi vendido

Eventos curados (isCurated) usam editor simplificado sem lotes/sessões dinâmicos.

Fila de espera

Quando um lote esgota, compradores entram na fila.

Fluxo de status


waiting → offered → purchased

                 ↘ expired

Status	Significado
`waiting`	Na fila, aguardando vaga
`offered`	Vaga liberada — 30 minutos para pagar
`purchased`	Pagamento concluído
`expired`	Oferta expirou; vaga volta para a fila

Regras importantes

Oferta dura 30 minutos (mínimo permitido pelo Stripe para expiração de checkout)

Na fila de espera (sem vaga imediata), máximo 1 ingresso por entrada

Ingressos gratuitos: limite de 5 por pessoa por evento

Lotes especiais (LoteTrans, LoteFlinta) têm regras próprias na fila

Cron a cada 10 minutos limpa ofertas expiradas e reprocessa a fila

Taxas em ingressos

Taxa da plataforma: 9% em compras a partir de 03/07/2026 14:06 BRT (5% antes dessa data). Ver Stripe e taxas.

O que acontece nos bastidores

O userId do evento é o dono da organização, não necessariamente quem preencheu o formulário (colaborador).

Eventos públicos com seguidores na org disparam notificação push na criação.

Vendas podem encerrar automaticamente via cron (autoCloseExpiredSales, a cada 2 min) se configurado.

Um evento só é considerado "passado" após a última sessão + horário de término.

Problemas comuns

Sintoma	Causa provável	O que fazer
Não vejo "+ evento"	Stripe sem payouts habilitados	Complete onboarding em `/guides`
Erro ao salvar: data principal	Só usou datas adicionais	Edite/confirme o campo Data principal
Erro: lotes zerados	Quantidade total = 0	Adicione quantidade em pelo menos um lote
Comprador perdeu a vaga	Oferta de 30 min expirou	Entrar na fila novamente
Não consigo reduzir ingressos	Já vendidos no lote	Só é possível aumentar a capacidade
Evento não aparece no mapa	Sem latitude/longitude ou fora das cidades ativas	Confirme localização (BH, Rio, SP)

Referências de código (time interno)

app/seller/new-event/page.tsx — rota de criação

app/seller/events/page.tsx — lista e gate Stripe

app/seller/events/[id]/edit/page.tsx — edição

components/event/EventForm.tsx — formulário principal

components/event/LoteFields.tsx — UI de lotes

components/seller/SellerEventCard.tsx — ações expandidas

convex/events.ts — create, updateEvent, joinWaitingList, virarLote

convex/eventBatches.ts — getEventSessions, getEventBatches

convex/waitingList.ts — fila e expiração

convex/constants.ts — TICKET_OFFER (30 min)