Bilheteria online para TYPO3

Organizadores pagam de 5 a 15% de comissão às plataformas de ingressos, quando o próprio site seria o melhor canal de venda

Eventim, Ticketmaster e Eventbrite cobram taxas por ingresso: entre 5 e 15% do preço, mais um valor fixo. Para um teatro que vende 50.000 ingressos por ano a um preço médio de 30 euros, isso dá de 75.000 a 225.000 euros de comissão por ano. Uma bilheteria direto no site em TYPO3 elimina essa comissão. A extensão permite vender ingressos online com escolha de assento, gestão de cotas, pagamento pelos provedores mais usados, e-ticket em PDF e validação por QR code na entrada. Para teatros, casas de show, conferências e espaços culturais municipais que vendem a maior parte dos ingressos a um público fiel e conhecido, é uma alternativa economicamente atraente.

Do teatro municipal à conferência técnica, a venda segue o mesmo roteiro

O cenário mais visível é o teatro ou a sala de concertos com mapa de assentos fixo: 400 lugares numerados, 50 deles na categoria premium, 200 na plateia e 150 no balcão. O espectador escolhe o lugar no mapa interativo, vê o preço e coloca o ingresso no carrinho. Depois do pagamento, recebe por e-mail o e-ticket em PDF com QR code. Na noite do espetáculo, a equipe lê o QR code com um smartphone. Todo o processo passa pelo site em TYPO3, sem intermediários.

O segundo cenário são conferências e feiras. Uma conferência técnica oferece três categorias de ingresso: early bird (até 8 semanas antes do evento), regular e VIP. As cotas limitam cada categoria a um número fixo. A bilheteria mostra a disponibilidade em tempo real: “Early bird: 12 de 100 disponíveis”. Encerrado o período de early bird, a categoria é desativada automaticamente.

Terceiro cenário: eventos municipais. Uma biblioteca pública oferece leituras, oficinas e atividades para crianças. Os ingressos são gratuitos, mas as vagas são limitadas. Aqui, a bilheteria funciona como sistema de reservas. Os visitantes reservam online, recebem uma confirmação e, se o evento lotar, entram numa lista de espera.

Registros de evento, mapa de assentos e gateway de pagamento formam a base técnica

A bilheteria tem quatro componentes: gestão de eventos, editor do mapa de assentos, checkout com integração de pagamento e geração de ingressos. Os eventos são cadastrados como registros Extbase no backend do TYPO3: título, data, horário, local, categorias, preços e cotas. O mapa de assentos fica guardado como gráfico SVG interativo, em que cada lugar tem um ID único vinculado ao sistema de cotas.

O checkout reúne os ingressos escolhidos, pede os dados de contato e encaminha a compra a um gateway de pagamento. Integrações comuns na Europa são Stripe, PayPal, Mollie e Worldline (antiga SIX Payment Services). No Brasil, vale escolher um gateway que aceite Pix (PT: MB WAY), como o Mercado Pago ou o PagBank. Com o pagamento aprovado, a extensão gera um ingresso em PDF com QR code (baseado num ID único de ingresso) e o envia por e-mail. O QR code contém uma URL ou um hash, validado na entrada.

A validação do QR code na entrada pode rodar num aplicativo web simples, que confere o ID do ingresso no banco de dados do TYPO3 e marca o status como “utilizado”. Cada ingresso só vale uma vez; duplicatas são recusadas.

Pagamento, cancelamento e editor do mapa de assentos concentram os problemas

O maior problema é o processamento do pagamento. O PCI DSS vale para quem armazena, processa ou transmite dados de cartão; se eles passam pelo próprio servidor, vale o catálogo completo de requisitos. Por isso, o pagamento roda num provedor certificado que ofereça um formulário de pagamento hospedado (hosted payment form), e aí em geral basta o questionário reduzido SAQ A. A extensão redireciona o comprador ao provedor para pagar e recebe o resultado por callback. Se o callback falha (timeout, reinício do servidor), o ingresso está pago, mas não aparece como pago. A solução: um job de conciliação que confere as transações em aberto junto ao provedor de pagamento.

Segundo problema: cancelamentos e reembolsos. Quando alguém cancela um ingresso, o pagamento precisa ser estornado e o lugar liberado de novo. Isso exige tanto um pedido de reembolso ao provedor de pagamento quanto uma mudança de status no banco de dados do TYPO3. Sem um fluxo automatizado de cancelamento, o processo é manual.

Terceiro ponto: o editor do mapa de assentos. Mapas SVG interativos com 400 lugares ou mais dão trabalho para montar. Cada lugar precisa de um ID, uma categoria e coordenadas. Mudanças no mapa (um setor novo, fileiras em outra ordem) exigem atualizar o arquivo SVG e os vínculos no banco de dados.

Bilheterias em TYPO3 são desenvolvimentos sob medida, sem padrão no TER

Não existe no TER, o repositório de extensões do TYPO3, uma extensão de bilheteria padrão que cubra todas as funções descritas. Bilheterias são quase sempre desenvolvimentos sob medida, ajustados às exigências de cada casa de espetáculos. Por isso, a compatibilidade com o TYPO3 depende do fornecedor contratado, e não de um ciclo de lançamentos da comunidade. Em novos projetos de bilheteria, a Gosign recomenda avaliar se uma arquitetura TYPO3 headless com um frontend especializado (React, Vue) não é mais fácil de manter a longo prazo do que uma solução Extbase monolítica.