Ticketshop dla TYPO3

Organizatorzy płacą 5 do 15 procent prowizji platformom biletowym, choć ich własna witryna byłaby lepszym kanałem sprzedaży

eBilet, Going., Ticketmaster i Eventbrite pobierają opłaty od biletu: między 5 a 15 procent ceny biletu plus stałą kwotę. Dla teatru z 50 000 sprzedanych biletów rocznie i średnią ceną 120 złotych daje to 300 000 do 900 000 złotych prowizji rocznie. Ticketshop bezpośrednio na witrynie TYPO3 eliminuje tę prowizję. Rozszerzenie umożliwia sprzedaż biletów online z wyborem miejsca, zarządzaniem kontyngentami, płatnością przez popularne bramki płatnicze, generowaniem e-biletów jako PDF i walidacją QR-Code przy wejściu. Dla teatrów, filharmonii, konferencji i samorządowych domów kultury, które sprzedają bilety głównie znanej publiczności abonamentowej, to ekonomicznie atrakcyjna alternatywa.

Typowe scenariusze sięgają od teatru miejskiego po konferencję branżową

Najbardziej widocznym scenariuszem jest teatr lub filharmonia ze stałym planem sali. 400 numerowanych miejsc, w tym 50 w kategorii Premium, 200 na parterze i 150 na balkonie. Odwiedzający wybiera miejsce na interaktywnym planie sali, widzi cenę i dodaje bilet do koszyka. Po opłaceniu otrzymuje e-bilet jako PDF z kodem QR mailem. Wieczorem przedstawienia obsługa skanuje kod QR smartfonem. Cały proces przebiega przez witrynę TYPO3, bez pośredników.

Drugim scenariuszem są konferencje i targi. Konferencja branżowa oferuje trzy kategorie biletów: Early Bird (do 8 tygodni przed wydarzeniem), Regular i VIP. Kontyngenty ograniczają każdą kategorię do stałej liczby. Ticketshop pokazuje dostępność w czasie rzeczywistym: “Early Bird: 12 ze 100 dostępnych”. Po upływie okresu Early Bird kategoria jest automatycznie dezaktywowana.

Trzeci scenariusz: wydarzenia samorządowe. Biblioteka miejska oferuje spotkania autorskie, warsztaty i wydarzenia dla dzieci. Bilety są bezpłatne, ale liczba miejsc ograniczona. Ticketshop pełni tu rolę systemu rezerwacji. Odwiedzający rezerwują online, otrzymują potwierdzenie, a w przypadku przekroczenia liczby miejsc trafiają na listę oczekujących.

Architektura techniczna łączy rekordy wydarzeń, plan sali i bramkę płatności

Ticketshop składa się z czterech komponentów: zarządzanie wydarzeniami, edytor planu sali, checkout z integracją płatności i generowanie biletów. Wydarzenia tworzy się jako rekordy Extbase w backendzie TYPO3: tytuł, data, godzina, miejsce, kategorie, ceny, kontyngenty. Plan sali zapisany jest jako interaktywna grafika SVG, w której każde miejsce ma unikalny identyfikator powiązany z systemem kontyngentów.

Proces checkoutu zbiera wybrane bilety, pyta o dane kontaktowe i przekierowuje do bramki płatności. Popularne integracje to Stripe, PayU, Przelewy24, Mollie i PayPal - dla polskiego rynku PayU i Przelewy24 są standardem, ponieważ obsługują BLIK i wszystkie polskie banki. Po pomyślnej płatności rozszerzenie generuje PDF biletu z kodem QR (na podstawie unikalnego ID biletu) i wysyła go mailem. Kod QR zawiera URL lub hash walidowany przy wejściu.

Walidację kodu QR przy wejściu można realizować przez prostą aplikację webową sprawdzającą ID biletu w bazie TYPO3 i ustawiającą status na “wykorzystany”. Bilet można wykorzystać tylko raz, duplikaty są odrzucane.

Częste problemy dotyczą płatności, anulowań i edytora planu sali

Największym problemem jest obsługa płatności. Zgodność z PCI-DSS wymaga, aby dane kart kredytowych nigdy nie dotykały własnego serwera. Dlatego płatność musi przebiegać przez certyfikowanego dostawcę płatności udostępniającego Hosted Payment Form. Rozszerzenie przekierowuje użytkownika do płatności u dostawcy i odbiera wynik przez callback. Gdy callback się nie powiedzie (timeout, restart serwera), bilet jest opłacony, ale nieoznaczony jako opłacony. Rozwiązanie: zadanie reconciliation sprawdzające otwarte transakcje u dostawcy płatności.

Drugi problem: anulowania i zwroty. Gdy odwiedzający anuluje bilet, płatność musi zostać zwrócona, a miejsce ponownie zwolnione. Wymaga to zarówno żądania refundu u dostawcy płatności, jak i zmiany statusu w bazie TYPO3. Bez zautomatyzowanego workflow anulowań jest to proces manualny. Polska ustawa o prawach konsumenta wymaga sprawnego zwrotu w przypadku anulowania wydarzenia.

Trzeci temat: edytor planu sali. Interaktywne plany sal SVG z 400 lub więcej miejscami są pracochłonne w tworzeniu. Każde miejsce wymaga ID, kategorii i współrzędnych. Zmiany w planie sali (nowy sektor, zmiana kolejności) wymagają aktualizacji pliku SVG i powiązań w bazie.

Rozszerzenia Ticketshop są custom-rozwojami bez standardu w TER

Nie istnieje standardowe rozszerzenie Ticketshop w TER TYPO3 obejmujące wszystkie opisane funkcje. Ticketshopy to niemal zawsze custom-rozwoje skrojone pod konkretne wymagania obiektu. Kompatybilność z TYPO3 zależy zatem od wykonawcy, a nie od cyklu wydawniczego społeczności. Gosign zaleca przy nowych projektach Ticketshop ocenić, czy headless’owa architektura TYPO3 z wyspecjalizowanym frontendem (React, Vue) nie jest długoterminowo bardziej utrzymywalna niż monolityczne rozwiązanie Extbase.