Skip to content

Billetto API-Dokumentation und Webhooks-Guide

So authentifizierst du dich, welche Endpunkte du aufrufst und wie Billetto-Webhooks Ticketdaten in Echtzeit an deine Systeme senden. Technische Guides für Entwickler, die auf Billetto aufbauen.
DEVELOPER HUB

Was du mit der Billetto API bauen kannst

Die Billetto API ist eine REST API, die JSON zurückgibt. Sie gibt deinem eigenen Code Zugriff auf dieselben Daten, mit denen dein Ticketverkauf läuft: Events, Tickettypen, Bestellungen, Teilnehmer, Buchungseinträge, Buchungsfragen und Zielgruppen. Webhooks senden dir Änderungen, sobald sie passieren, sodass du nicht danach fragen musst.

Teams nutzen sie, um Käufer in ein CRM zu synchronisieren, Verkäufe in ein Data Warehouse zu laden, Events auf der eigenen Website anzuzeigen, Mitglieder zu Presale-Zielgruppen hinzuzufügen und Auszahlungen im Finanzsystem abzugleichen. Diese Seite erklärt, wie die API aufgebaut ist und wie Webhooks funktionieren. Das vollständige Schema jedes Endpunkts findest du in der API-Referenz.

Hier starten

AUTHENTIFIZIERUNG

Mit API-Schlüsselpaar oder OAuth 2.0 authentifizieren

API-Schlüsselpaare für dein eigenes Konto

Nutze ein Schlüsselpaar, wenn deine eigenen Systeme die API im Namen deines Veranstalterkontos aufrufen. Erstelle es in Billetto unter Integrations → Developers → API - Key pairs, gib ihm einen Namen, der den Zweck beschreibt (zum Beispiel "CRM-Sync" oder "Data Warehouse"), und sende es bei jedem Aufruf im Header Api-Keypair mit.

  • Lege pro System ein eigenes Schlüsselpaar an, damit du eines widerrufen kannst, ohne die anderen zu beeinträchtigen
  • Bewahre das Secret auf deinem Server auf. Liefere es nie in einem Browser, einer mobilen App oder einem öffentlichen Repository aus
  • Widerrufe und ersetze ein Schlüsselpaar sofort, wenn du vermutest, dass es öffentlich geworden ist

OAuth 2.0 für Apps, die andere Veranstalter nutzen

Nutze OAuth, wenn du ein Produkt entwickelst, mit dem sich andere Billetto-Veranstalter verbinden, zum Beispiel ein Marketing-Tool, eine Event-Plattform oder ein Agentur-Dashboard. OAuth verwendet den Authorization-Code-Flow: Der Veranstalter meldet sich bei Billetto an, genehmigt deine App und du erhältst ein Token für sein Konto. Du siehst nie sein Passwort, und er kann deine App jederzeit trennen.

Beide Methoden werden Schritt für Schritt im Einstiegs-Guide beschrieben.

Events und Tickettypen

Rufe die Events deines Kontos mit Datum, Veranstaltungsort, Status und Tickettypen ab.

  • GET /organiser/events listet deine Events
  • Tickettypen, Preise und Verfügbarkeit pro Event
  • Buchungsfragen, die du Käufern im Checkout stellst

Typischer Einsatz

Zeige deine kommenden Events mit Live-Verfügbarkeit auf deiner eigenen Website oder App und leite Käufer zum Billetto-Checkout weiter.

Bestellungen und Teilnehmer

Sieh, wer was wann für welches Event gekauft hat.

  • GET /organiser/orders listet Bestellungen über alle deine Events
  • GET /organiser/events/{event_id}/attendees listet die Teilnehmer eines Events
  • Ergebnisse kommen seitenweise: Rufe die nächste Seite ab, bis keine mehr kommt

Typischer Einsatz

Halte Käuferdaten in deinem CRM aktuell oder sende Teilnehmerlisten an ein Einlass- oder Akkreditierungssystem.

Buchungseinträge und Berichte

Erhalte die finanziellen Details hinter deinen Ticketverkäufen.

  • GET /organiser/ledger_entries listet Verkäufe, Erstattungen, Gebühren und Auszahlungen
  • Ein BI-Bericht pro Event mit den wichtigsten Verkaufszahlen

Typischer Einsatz

Lade Umsätze in deine Buchhaltung oder dein Data Warehouse und gleiche sie mit deinen Auszahlungen ab.

Zielgruppen und Mitglieder

Schreibe Daten zurück zu Billetto, statt sie nur zu lesen.

  • Mitglieder von Zielgruppen anlegen, aktualisieren und entfernen
  • Ganze Listen importieren und den Importstatus verfolgen
  • Eine Zielgruppe und ihre Mitgliederzahl abrufen

Typischer Einsatz

Synchronisiere Mitglieder, Abonnenten oder Partnerlisten aus deinem CRM mit Audiences für Presales und exklusive Angebote.

Webhook-Abonnements

Verwalte Webhooks per Code statt in der Billetto-Oberfläche.

  • POST /organiser/webhooks registriert eine Endpunkt-URL
  • Einen bestehenden Webhook aktualisieren oder entfernen
  • Ein neues Signatur-Secret für einen Webhook erzeugen

Typischer Einsatz

Registriere Webhooks automatisch, wenn ein neuer Kunde oder eine neue Umgebung eingerichtet wird, und tausche Secrets nach Plan aus.

Public Event Search

Durchsuche Events, die öffentlich auf Billetto gelistet sind, über alle Veranstalter hinweg.

  • Abfrageparameter zum Eingrenzen der Ergebnisse, in der Referenz beschrieben
  • Jedes Ergebnis verlinkt auf die Eventseite und den Checkout

Typischer Einsatz

Medien, Stadtführer und Partnerplattformen zeigen damit, was los ist, mit Tickets, die über Billetto verkauft werden.

IN DER PRAXIS

Die Billetto API und Webhooks, Schritt für Schritt

APISchritt 1: Zugang

Schlüsselpaar erstellen und den ersten Aufruf senden

Öffne Integrations, wechsle zum Tab Developers und erstelle ein Schlüsselpaar für das System, das du anbindest. Kopiere das Secret, füge es deinen Request-Headern hinzu und rufe einen Endpunkt wie /organiser/orders auf. Die Antwort ist JSON, das du direkt in dein eigenes Datenmodell übernehmen kannst.

  • Ein Schlüsselpaar pro Integration, benannt nach dem System, das es nutzt
  • JSON-Antworten für Events, Bestellungen, Teilnehmer und Buchungseinträge
  • Ein Schlüsselpaar jederzeit widerrufen, ohne die anderen zu beeinträchtigen
API-Referenz öffnen

AUDIENCESSchritt 2: an Billetto schreiben

Kontakte per API zu einer Zielgruppe hinzufügen

Die Audiences-Endpunkte sind der wichtigste Weg, Daten in Billetto zu schreiben. Sende Kontakte aus deinem CRM an eine Zielgruppe oder importiere eine ganze Liste und prüfe den Status, bis sie fertig ist. Danach ist die Gruppe bereit für Einladungen, Presales und exklusive Angebote.

  • Mitglieder einzeln hinzufügen, aktualisieren und entfernen
  • Massenimporte mit einem Status, den du abfragen kannst
  • Gruppen erscheinen sofort in Audiences

WEBHOOKSSchritt 3: Billetto-Webhooks

Webhook registrieren und Zustellungen live sehen

Füge deine Endpunkt-URL im Tab Developers hinzu, und Billetto erzeugt ein Signatur-Secret dafür. Ab dann wird jede Bestellung, Erstattung, Teilnehmeränderung oder Event-Veröffentlichung als HTTP POST mit JSON-Body an deine URL gesendet.

  • Einrichtung in der Oberfläche oder per POST /organiser/webhooks
  • Ein Signatur-Secret pro Webhook, das du neu erzeugen kannst
  • Die Webhooks-Karte zeigt URL und API-Version jedes Webhooks
Webhook-Referenz lesen
BILLETTO-WEBHOOKS

Was Billetto-Webhooks sind und wann du sie nutzt

Ein Webhook ist eine URL auf deinem Server, die Billetto aufruft, wenn sich in deinem Konto etwas ändert. Statt die API alle paar Minuten nach neuen Bestellungen zu fragen, erhältst du einen Aufruf in dem Moment, in dem eine Bestellung angelegt, erstattet oder geändert wird.

Deshalb sind Webhooks das richtige Werkzeug, wenn Timing zählt: eine Bestätigung im CRM innerhalb von Sekunden, eine Slack-Nachricht, wenn ein VIP-Ticket verkauft wird, oder ein Einlasssystem, das von einem stornierten Ticket wissen muss, bevor die Türen öffnen.

Webhooks oder API?

  • Nutze Webhooks, um auf Änderungen zu reagieren, sobald sie passieren: neue Bestellungen, Erstattungen, Teilnehmeränderungen und veröffentlichte Events
  • Nutze die API, um Historie zu laden, einen nächtlichen Komplettabgleich auszuführen oder Details abzurufen, die ein Webhook nicht enthält
  • Nutze beides für die zuverlässigste Lösung: Webhooks für Tempo und einen geplanten API-Abgleich, der alles auffängt, was du verpasst hast
SO FUNKTIONIERT ES

So wird ein Billetto-Webhook zugestellt

Vom Verkauf eines Tickets bis zur Verarbeitung in deinem System.
1
ENDPUNKT REGISTRIEREN
Füge eine öffentliche HTTPS-URL im Tab Developers oder per API hinzu und speichere das Signatur-Secret, das Billetto dir gibt.
2
ETWAS ÄNDERT SICH
Ein Käufer bestellt, ein Ticket wird erstattet, Teilnehmerdaten werden geändert oder du veröffentlichst ein Event.
3
BILLETTO SENDET EINEN POST
Billetto sendet einen HTTP POST mit einem JSON-Body, der die Änderung beschreibt, an deine URL.
4
PRÜFEN UND ANTWORTEN
Prüfe den Aufruf mit deinem Signatur-Secret, antworte mit einem 2xx-Status und verarbeite die Daten im Hintergrund.
WEBHOOK BEST PRACTICES

Einen zuverlässigen Webhook-Empfänger bauen

Sicherheit

  • Prüfe jeden Aufruf mit dem Signatur-Secret des Webhooks, bevor du dem Inhalt vertraust. Die Webhook-Referenz beschreibt, wie
  • Akzeptiere nur HTTPS und speichere das Secret in der Serverkonfiguration, nicht im Code
  • Erzeuge ein neues Secret, wenn es offengelegt worden sein könnte, und aktualisiere dann deinen Empfänger

Zuverlässigkeit

  • Antworte schnell. Gib einen 2xx-Status zurück, sobald der Aufruf geprüft ist, und erledige die aufwendige Arbeit in einer Queue
  • Behandle Duplikate. Speichere verarbeitete IDs, damit dieselbe Bestellung nie doppelt angelegt wird
  • Verlass dich nicht auf die Reihenfolge. Wenn sie wichtig ist, rufe den aktuellen Stand der Bestellung über die API ab
  • Gleiche regelmäßig ab. Ein geplanter API-Abgleich fängt auf, was dein Endpunkt während eines Ausfalls verpasst hat
Vollständige Endpunkt-Dokumentation

Billetto API-Referenz

Die API-Referenz dokumentiert jeden Endpunkt mit Parametern, Beispielaufrufen und Antwortobjekten. Nutze sie zusammen mit diesem Guide, wenn du mit dem Programmieren beginnst: Finde oben die passende Ressource und schlage dann die genauen Felder in der Referenz nach.

Die Webhook-Ressource

Webhook-Referenz

Die Webhook-Ressource enthält die Konfiguration eines Endpunkts: seine URL, die verwendete API-Version und sein Signatur-Secret. Wir empfehlen, den ersten Webhook in Billetto unter Integrations → Developers anzulegen und ihn per API zu verwalten, sobald dein Setup wächst.

Öffentliche Events aller Veranstalter

Public Event Search API

Die Public Event Search API liefert Events, die Veranstalter öffentlich auf Billetto gelistet haben, über alle Veranstalter hinweg. Sie eignet sich für Medienseiten, Stadtführer, Tourismusorganisationen und Partner-Apps, die zeigen wollen, was los ist, wobei jedes Ergebnis auf die Billetto-Eventseite verlinkt, auf der Tickets gekauft werden.

FAQ ZU API UND WEBHOOKS

Fragen zur Billetto API und zu Webhooks

Technische Fragen von Entwicklern, die mit der Billetto API arbeiten. Fehlt eine Antwort? Sprich mit unserem Team.

Wo finde ich meinen Billetto API-Schlüssel?

Melde dich bei Billetto an, öffne Integrations und wechsle zum Tab Developers. Unter API - Key pairs kannst du ein neues Schlüsselpaar erstellen, sehen, wem jedes gehört, und nicht mehr genutzte Schlüssel widerrufen.

Was ist der Unterschied zwischen einem API-Schlüsselpaar und OAuth?

Ein Schlüsselpaar gibt deinen eigenen Systemen Zugriff auf dein eigenes Veranstalterkonto. OAuth 2.0 ist für Apps, die andere Veranstalter mit ihrem Billetto-Konto verbinden, sodass du in ihrem Namen handelst, ohne ihre Anmeldedaten zu kennen.

Welche Ereignisse können Billetto-Webhooks senden?

Webhooks decken Änderungen an Bestellungen, Teilnehmern und Events ab, etwa neue Bestellungen, Erstattungen, Teilnehmeränderungen und veröffentlichte Events. Die Webhook-Referenz listet alle Ereignisse und ihre Inhalte.

Wie prüfe ich, ob ein Webhook-Aufruf von Billetto stammt?

Jeder Webhook hat sein eigenes Signatur-Secret. Prüfe damit jeden eingehenden Aufruf, bevor du ihn verarbeitest, und lehne Aufrufe ab, die die Prüfung nicht bestehen. Du kannst jederzeit ein neues Secret für einen Webhook erzeugen.

Kann ich Webhooks per API anlegen?

Ja. Du kannst Webhooks über die Webhook-Endpunkte registrieren, aktualisieren und entfernen und für einen bestehenden Webhook ein neues Signatur-Secret erzeugen. Die meisten Teams starten in der Oberfläche und wechseln zur API, wenn sie mehrere Umgebungen verwalten.

Was tue ich bei einer HTTP-429-Antwort?

429 bedeutet, dass du zu viele Aufrufe sendest. Warte und versuche es mit wachsender Pause erneut, und nutze Webhooks statt häufigem Polling, um die Zahl der Aufrufe niedrig zu halten.

Kann ich Billetto-Events auf meiner eigenen Website oder Plattform zeigen?

Ja. Nutze die Public Event Search API für öffentlich gelistete Events auf Billetto oder den Events-Endpunkt des Veranstalters für deine eigenen Events. Käufer schließen den Kauf im Billetto-Checkout ab.

Ich bin kein Entwickler. Kann ich Billetto trotzdem mit anderen Tools verbinden?

Ja. Google Analytics 4, das Meta Pixel, Zapier und dein eigener Zahlungsanbieter lassen sich ohne Code verbinden. Unter Billetto-Integrationen siehst du, was du in wenigen Minuten einrichten kannst.

Bereit für deinen ersten Aufruf?

Erstelle ein Schlüsselpaar unter Integrations, öffne die Referenz und rufe deinen ersten Endpunkt auf. Wenn du Google Analytics, das Meta Pixel oder Zapier lieber ohne Code verbinden möchtest, starte mit den Billetto-Integrationen.