API-Zugang für Ticketing: Eigene Integration statt Standard-Checkout

Die eigene Veranstalterseite unter tcktnest.com/dein-name reicht für die meisten Events völlig aus: Event anlegen, Link teilen, Käufer:innen landen auf einer sauberen Checkout-Seite mit deinem Branding. Für einen Großteil der Veranstalter – von der Band, die ihre nächste Show ankündigt, bis zum Verein, der den Maturaball organisiert – ist das genau der richtige Weg.

Es gibt aber eine andere Gruppe: Venues mit eigener Website und eigenem CMS, Veranstalter mit einem bestehenden internen Buchungssystem, oder Betreiber, die eine eigene App haben und Ticketverkauf dort nahtlos einbauen wollen, statt Besucher:innen auf eine externe Seite weiterzuleiten. Für genau diesen Fall gibt es bei TCKTNEST einen API-Zugang. Dieser Artikel erklärt, wofür er gedacht ist, was er kann – und wo die Grenzen liegen.

Wann lohnt sich eine eigene Integration überhaupt?

Bevor es an die Technik geht, lohnt sich die Grundfrage: Brauchst du das wirklich? Für die meisten Anwendungsfälle ist die Antwort nein – der Standard-Checkout und das einbettbare Widget (dazu unten mehr) decken den überwiegenden Teil ab, ohne dass jemand Code schreiben muss.

Eine eigene Integration über die API lohnt sich typischerweise, wenn mindestens einer dieser Punkte zutrifft:

• Du hast eine bestehende Website mit eigenem Design-System und willst den Kaufprozess optisch und technisch vollständig in dein eigenes Frontend integrieren, nicht nur einbetten.
• Du betreibst ein internes Kassen- oder Abendkassensystem (z. B. an der Venue-Rezeption) und willst Tickets und Merch direkt aus diesem System heraus verkaufen können, statt Personal auf eine separate Oberfläche wechseln zu lassen.
• Du hast eine eigene App (iOS/Android oder Web) für deine Community oder dein Venue-Programm und willst Ticketkauf als Teil dieses Produkts anbieten.
• Du verkaufst über mehrere eigene Kanäle gleichzeitig (Website, App, Kiosk-Terminal) und willst den Checkout-Prozess an einer Stelle programmatisch steuern, statt drei getrennte manuelle Setups zu pflegen.

Wenn keiner dieser Punkte zutrifft, ist die Standardlösung mit hoher Wahrscheinlichkeit die schnellere und robustere Wahl.

Was die TCKTNEST-API konkret ist

Die Public API (aktuell Version 1) erlaubt es, Ticket-Checkout und Merch-Bestellungen programmatisch in eigene Systeme einzubinden – statt Besucher:innen über den Standard-Checkout auf tcktnest.com zu schicken. Den API-Key dafür generierst du selbst in den Einstellungen deines Dashboards; es braucht keinen Support-Kontakt und keine gesonderte Freischaltung.

Wichtig für die Einordnung: Es handelt sich um einen Checkout-Integrationspunkt, keine vollständige Nachbildung des Dashboards. Die Kernlogik – Preisberechnung inklusive Plattformgebühr, Zahlungsabwicklung über Stripe Connect, QR-Ticket-Erstellung, Rabattlogik – läuft weiterhin bei TCKTNEST. Deine eigene Oberfläche stößt den Kaufprozess an; die Abwicklung im Hintergrund bleibt dieselbe wie beim Standard-Checkout, inklusive Gebührenmodell deines Plans und ob du die Gebühr absorbierst oder an Käufer:innen weitergibst.

Das ist ein bewusster Unterschied zu einer offenen "baue alles selbst"-API: Du bekommst die Kontrolle über die Präsentation und den Einbindungsort, ohne Zahlungsabwicklung, Steuerlogik oder QR-Code-Generierung selbst nachbauen zu müssen.

Konkrete Anwendungsfälle

Kassensystem an der Abendkasse. Wenn deine Venue bereits ein internes System für Abendkasse oder Reservierungen betreibt, kann dieses System über die API direkt einen Checkout auslösen, statt Personal zwei getrennte Tools bedienen zu lassen.

Eigene Buchungsstrecke auf der Website. Manche Venues wollen den kompletten Ablauf – Datum wählen, Kategorie wählen, bezahlen – optisch nahtlos im eigenen Website-Design abbilden, ohne dass an irgendeinem Punkt ein sichtbarer Wechsel zu einer anderen Domain passiert. Die API macht diesen nahtlosen Übergang möglich.

Merch-Bestellungen aus der eigenen App. Wer über die App-Integration hinaus auch Merch anbietet, kann Bestellungen über denselben API-Zugang abwickeln – das gleiche Prinzip wie beim Ticketkauf, nur für Produkte statt Tickets.

Mehrere Vertriebskanäle, eine Datenquelle. Wer parallel über Website, App und ein Kiosk-Terminal verkauft, kann alle drei über dieselbe API ansteuern, statt für jeden Kanal eine eigene Insellösung zu pflegen.

Die einfachere Zwischenlösung: das einbettbare Widget

Nicht jeder, der "keinen sichtbaren Wechsel zu einer fremden Seite" will, braucht gleich eine volle API-Integration. Für viele reicht das einbettbare Widget: Der Ticketshop eines Events lässt sich als iFrame direkt auf der eigenen Website einbetten, ganz ohne Programmierung der Checkout-Logik selbst. Besucher:innen bleiben optisch auf deiner Seite, der eigentliche Kaufprozess läuft aber technisch weiterhin über die bewährte TCKTNEST-Oberfläche im eingebetteten Fenster.

Das Widget ist die richtige Wahl, wenn du "auf meiner Website kaufbar" willst, ohne eigene Checkout-Logik zu bauen. Die API ist die richtige Wahl, wenn du die Kauflogik wirklich in ein bestehendes System integrieren willst – Kassensystem, App, oder eine komplett eigene Buchungsstrecke.

Was die API nicht ersetzt

Zur Einordnung, damit keine falschen Erwartungen entstehen: Die Einlasskontrolle läuft weiterhin über die QR-Code-Scan-PWA im Browser des Türpersonals – dafür braucht es keine separate Hardware oder App-Store-App, und das bleibt unabhängig davon, ob Tickets über den Standard-Checkout, das Widget oder die eigene API-Integration verkauft wurden. Ein über die API verkauftes Ticket ist technisch identisch mit einem über den Standard-Checkout verkauften: gleicher QR-Code, gleiche Gültigkeitsprüfung, gleiche Auflistung im Dashboard und im CSV-Export.

Rückerstattungen laufen ebenfalls unverändert über das eigene Stripe-Konto des Veranstalters (oder Stripes Dashboard/API) – nicht über einen separaten API-Endpunkt bei TCKTNEST. Der Webhook erkennt eine Stripe-Rückerstattung automatisch und markiert das Ticket als storniert, unabhängig vom Verkaufsweg.

Wie du startest

Der API-Key lässt sich direkt in den Einstellungen im Dashboard generieren – kein Antrag, keine Wartezeit auf Freischaltung. Bevor du mit der eigentlichen Integration beginnst, lohnt sich ein kurzer Realitätscheck: Hast du intern die Kapazität, eine Checkout-Integration zu bauen und zu warten (Fehlerfälle, Zahlungsstatus, QR-Code-Zustellung an Käufer:innen)? Wenn ja, ist die API der richtige Weg für ein Setup, das exakt zu deinem bestehenden System passt. Wenn diese Kapazität gerade fehlt, ist ein Start mit dem Standard-Checkout oder dem einbettbaren Widget der pragmatischere erste Schritt – die API bleibt jederzeit später verfügbar, ohne dass du das Konto wechseln oder Daten migrieren musst.

Jetzt kostenlos registrieren und API-Key generieren →