Validação e dia do evento

Para quem: produtor, equipe de porta, operação no local

Última revisão: 2026-07-13

Rotas relacionadas: /seller/validate-ticket/[password], /seller/validate-ticket/bar/[barPassword], /seller/validate-ticket/store/[id]

O que você consegue fazer

Validar ingressos por QR code na entrada

Buscar ingressos por e-mail e validar manualmente

Validar consumo no bar digital

Validar compras na loja da organização

Pré-requisitos

Evento criado com ingressos vendidos

Link ou senha de validação do evento (gerada automaticamente na criação)

Dispositivo com câmera (para QR) ou teclado (para busca por e-mail)

Conexão com internet no local (validação é em tempo real via Convex)

Passo a passo — Validar ingressos do evento

1. Acessar a página de validação

No card expandido do evento em /seller/events, clique em validar tickets.

A rota é /seller/validate-ticket/{password} — a senha tem 12 caracteres e é única por evento.

Atenção: este link contém a senha do evento. Compartilhe apenas com pessoas de confiança na equipe de porta. A UI exibe aviso de segurança ao abrir o link.

2. Validar por QR code

Aponte a câmera para o QR do ingresso (no app do comprador ou e-mail)

O scanner lê o ID do ticket no Convex

Se válido: status muda para used, checkinTime é registrado, feedback de sucesso

Scanner reseta após ~1 segundo para o próximo ingresso

QR inválido: URLs, textos aleatórios ou IDs fora do formato são rejeitados.

3. Validar por e-mail

Digite o e-mail do comprador (autocomplete após 3 caracteres)

A lista mostra ingressos do evento para aquele e-mail

Clique para validar cada ingresso individualmente

Útil quando o comprador não consegue exibir o QR (bateria, tela quebrada, etc.).

4. Resultados possíveis

Resultado	Significado
Sucesso	Ingresso `valid` → marcado como `used`
Já usado	Ingresso já validado anteriormente (`checkinTime` exibido)
Reembolsado / cancelado	Ingresso não pode entrar

Validação no bar digital

Rota: /seller/validate-ticket/bar/{barPassword}

Usa events.getByBarPassword para identificar o evento/bar

Scanner específico: QrScannerBar

Busca por e-mail: BarTicketSearchByEmail

Acesse pelo painel do bar em /seller/bar/[id] ou pelo card do evento.

Validação na loja

Rota: /seller/validate-ticket/store/[id]

Para retirada/validação de produtos comprados na loja da organização.

Certificado de participação

Após check-in (status: used), o comprador pode acessar certificado em /tickets/[id]/certificate se o evento tiver issueCertificate ativo.

O que acontece nos bastidores

Mutation tickets.validateTicketStatus só aceita tickets com status: valid

Check-in é irreversível pela validação padrão (não "desvalida" pelo scanner)

A senha do evento (events.password) é diferente da senha do bar (barPassword)

Eventos curados não exibem link de validação de ingressos no card do seller

Problemas comuns

Sintoma	Causa provável	O que fazer
QR não lê	Luz ruim ou QR de outro evento	Use busca por e-mail
"Já usado"	Check-in duplicado	Verifique `checkinTime`; pode ser tentativa de reentrada
Página não carrega evento	Senha errada na URL	Copie link de validar tickets do card do evento
Câmera não abre	Permissão negada no browser	Libere câmera nas configurações do navegador
Ingresso não aparece na busca	E-mail diferente do da compra	Confirme e-mail usado no checkout

Referências de código (time interno)

app/seller/validate-ticket/[password]/page.tsx — validação de ingressos

app/seller/validate-ticket/bar/[barPassword]/page.tsx — bar

app/seller/validate-ticket/store/[id]/page.tsx — loja

components/seller/QrScanner.tsx — scanner de ingressos

components/seller/TicketSearchByEmail.tsx — busca por e-mail

convex/tickets.ts — validateTicketStatus, searchEventTicketsByEmail

convex/events.ts — getByPassword, getByBarPassword