Storefront, Embed und API

Deine Events lassen sich über ontickets.de hinaus verkaufen: auf einer eigenen Veranstalter-Website, eingebettet in deine bestehende Homepage oder über eine Schnittstelle in anderen Systemen. Diese Seite beschreibt die Werkzeuge dafür und die Einstellungen für Team, Auswertung und Aussehen. Sie richtet sich an Veranstalter und an die Leute, die deine Website oder Technik betreuen.

Storefront (Veranstalter-Website)

Die Storefront ist eine eigene, gebrandete Verkaufsseite unter deiner Subdomain und optional unter deiner eigenen Domain. Du öffnest sie in der Seitenleiste unter „Storefront“.

Buchen

Die Storefront ist ein Zusatzmodul. Ist es noch nicht gebucht, zeigt die Seite den Bereich „Abrechnung“.

Zahlweise	Preis
monatlich	59 EUR im Monat inkl. USt, monatlich kündbar zum Monatsende
jährlich	Jahrespreis inkl. USt im Voraus, entspricht zwei geschenkten Monaten

Der Buchungsmonat ist gratis. Bei monatlicher Zahlung entfällt die Monatsgebühr in jedem Monat, in dem du mindestens 1.500 EUR Ticketumsatz über on:Tickets machst. Abgerechnet wird per SEPA-Lastschrift. Fehlt noch ein Mandat, richtest du es einmalig bei Stripe ein.

1. Wähle die Zahlweise.
2. Bestätige die „Zusatzbedingungen für Zusatzmodule (§ 5a)“.
3. Klick auf „Jetzt buchen“.

Mit „Modul kündigen“ endet das Modul zum Monatsende.

warnung

Die Buchung ist kostenpflichtig. Die genannten Preise sind die Standardpreise, maßgeblich ist der Betrag auf der Buchungsseite.

Sektionen

Unter „Sichtbare Sektionen“ wählst du, was die Website zeigt. Eine Bar oder ein Restaurant kann auch ohne Veranstaltungsprogramm starten.

Sektion	Inhalt
Hero	Kopfbereich mit Logo und Hintergrund
Events	Veranstaltungsprogramm
Lineup	Künstler kommender Events
Galerie	Bilder
About	Beschreibung
Info	Öffnungszeiten, Kontakt, Anfahrt
Karte	Speisen und Getränke
Häufige Fragen	eigene Antworten
Gruppen und private Feiern	Anfrageformular
Lounges	kommende Events mit buchbarer Lounge
Archiv	vergangene Events
Jobs	Stellenangebote

Weitere Einstellungen auf derselben Seite:

• Öffnungszeiten mit Nachtbetrieb, „24 Stunden geöffnet“ und „Sonderöffnungszeiten und Schließtage“,
• öffentliche Betriebsadresse, Telefon und Anfahrt,
• „SEO-Hoheit (Canonical-Ziel)“: ob Suchmaschinen die Portal-Seite oder deine Storefront bevorzugen. Schalte das nicht hin und her, jeder Wechsel braucht Wochen, bis Suchmaschinen neu gecrawlt haben,
• „Startseite nicht indexieren“ für Test- und Musterseiten,
• eigene Google-Analytics-Property und Meta Pixel. Beide messen erst nach Einwilligung der Besucher,
• „Impressum der Storefront“, vorbefüllbar mit „Aus Stammdaten übernehmen“.

Speichere mit „Einstellungen speichern“. Mit „Private Vorschau öffnen“ siehst du die Seite vor der Freigabe.

Eigene Domain

1. Trag unter „Eigene Domain“ deine Domain ein, empfohlen ist www.deinedomain.de, und klick auf „Domain anlegen“.
2. Setz bei deinem DNS-Anbieter den CNAME-Eintrag, den dir die „CNAME-Anleitung“ anzeigt.
3. Klick auf „Prüfen“.

Der Status wechselt von „ausstehend“ auf „aktiv“, sobald die Domain stimmt. Das Zertifikat wird automatisch ausgestellt. Bei „fehlgeschlagen“ prüfst du den DNS-Eintrag und klickst erneut auf „Prüfen“. „Entfernen“ löst die Domain wieder.

Sprache

Die Sprache der Storefront legst du im Profil unter „Sprache der Storefront“ fest. Sie gilt für Besucher, die keine eigene Sprache gewählt haben.

Gastronomie

Für Bars und Restaurants gibt es drei Werkzeuge:

Menüpunkt	Wofür
Reservierungen	Bereiche mit Gästezahl und Aufenthaltsdauer, Tagesübersicht, offene Anfragen und „Telefonische Reservierung erfassen“
Gruppen & Feiern	Anfragen für Gruppen und private Feiern mit Bearbeitungsstatus „Offen“ oder „Erledigt“
Karte	Speise- und Getränkekarte mit Kategorien, Preisen, Allergenen und QR-Code

Bestätigte Reservierungen belegen Plätze. Offene Anfragen und Feier-Anfragen halten keine Plätze frei. Der Bearbeitungsstatus einer Anfrage ist nur für dein Team sichtbar und verschickt keine Nachricht.

hinweis

Reservierungen und Anfragen sind je Mandant freigeschaltet. Neue Bereiche bleiben inaktiv, bis die Einrichtung abgeschlossen ist.

Embed

Mit dem Embed-Widget zeigst du deine Events auf deiner eigenen Website.

1. Öffne unter „Integrationen“ den Punkt „Embed“.
2. Prüf die „Vorschau“.
3. Klick unter „Embed Code“ auf „Kopieren“ und füg den Code in deine Website ein.

Der Code bindet ein Fenster mit deinen Events ein. Für eigene Darstellungen gibt es zusätzlich einen JSON-Feed deiner Events. Er liefert zu jedem Preis die Gebühreninformation („feeInfo“), damit eine fremde Seite den Endpreis inklusive Servicegebühr korrekt anzeigen kann.

hinweis

Embed ist ein Modul, das je Mandant freigeschaltet wird.

Partner-API

Über die Partner-API lesen andere Systeme deine Events, Locations, Künstler und Veranstalter aus. Die Endpunkte liegen unter /api/v1/events, /api/v1/venues, /api/v1/artists und /api/v1/organizers. Mit updated_since holst du nur Änderungen seit einem Zeitpunkt. Die vollständige Beschreibung steht unter /openapi.json.

Zugriff	Limit
ohne API-Key	60 Anfragen pro Minute je IP-Adresse
mit API-Key	300 Anfragen pro Minute je Key

Einen Key legst du unter „API Keys“ an:

1. Gib unter „Neuen API Key erstellen“ einen „Namen“ ein und klick auf „Key erstellen“.
2. Kopiere den Key sofort. Er ist nur einmal sichtbar.
3. Sende ihn im Header als Authorization: Bearer mit dem Key dahinter.

Mit „Widerrufen“ sperrst du einen Key endgültig.

hinweis

API Keys sind ein Modul, das je Mandant freigeschaltet wird.

Feeds

Für Kalender, Newsreader und Aggregatoren gibt es öffentliche Feeds der kommenden Events:

Feed	Adresse
RSS	/feed/events.xml
JSON Feed	/feed/events.json
iCal	/feed/events.ics

Die Feeds lassen sich mit ?city=, ?genre= und ?organizer= filtern. Dieselben Formate gibt es je Location unter /feed/venues/ und je Künstler unter /feed/artists/, jeweils gefolgt vom Slug und der Endung.

Webhooks

Webhooks melden Ereignisse sofort an dein eigenes System.

1. Öffne unter „Integrationen“ den Punkt „Webhooks“.
2. Trag unter „Neuen Webhook erstellen“ die URL ein. Erlaubt sind nur öffentliche https-Adressen.
3. Wähle die „Events“: ticket.claimed, ticket.cancelled, ticket.scanned, event.published, event.cancelled.
4. Klick auf „Webhook erstellen“ und notiere das Secret aus der Bestätigung.

Jede Nachricht ist mit HMAC-SHA256 über den JSON-Inhalt signiert. Die Signatur steht im Header X-Webhook-Signature, das Ereignis in X-Webhook-Event. Antwortet dein System zehnmal hintereinander mit einem Fehlerstatus, schaltet das System den Webhook ab. Timeouts und Netzfehler werden mitgezählt, schalten ihn aber nicht ab. Unter „Aktive Webhooks“ siehst du Status, letzte Auslösung und Fehlerzahl und schaltest ihn wieder ein.

hinweis

Webhooks sind ein Modul, das je Mandant freigeschaltet wird.

Team

Unter „Team“ lädst du Mitarbeitende ein: „Mitglied einladen“, E-Mail und Rolle eintragen, „Einladen“.

Rolle	Darf
Admin	alles wie der Inhaber, inklusive Team-Verwaltung
Editor	Events bearbeiten und veröffentlichen, Tickets, Gutscheincodes, Teilnehmer, Scannen, Abendkasse verkaufen
Viewer	alles lesen, auch Finanzen
Einlass (nur Scanner)	Teilnehmer sehen, scannen, an der Abendkasse verkaufen
Reservierungen (ohne Finanzen)	Reservierungen verwalten

Darunter steht „Einlasspersonal“ mit allen eventbezogenen Scan-Zugängen. Sie laufen mit dem Event aus und geben keine Team-Rechte. Wie du sie anlegst, steht unter Einlass und Scanner.

Analytics

„Analytics“ zeigt Buchungen, Auslastung und Share-Tracking. Du wählst den Zeitraum (7, 30, 90 Tage oder 1 Jahr) und ein Event. Mit Event siehst du KPI-Karten, Verkaufsverlauf und Kontingent-Auslastung. Das Share-Tracking zählt Klicks auf geteilte Links nach Quelle. Kampagnen-Parameter aus Links (UTM) werden an der Bestellung gespeichert.

Ticket-Design und Theme

Menüpunkt	Was du einstellst	Wo es wirkt
Ticket-Design	Hintergrund-, Akzent- und QR-Code-Farbe, Schriftart, Logo-Position, zwei eigene Felder (etwa Dresscode)	Tickets im Wallet, mit Vorschau
Theme	Farbpalette, Schriftart, Hintergrundbild, Sponsor-Logos, eigenes CSS	öffentliches Profil, Events, Checkout, Tickets und Embed-Widget

Bilder für das Theme dürfen JPG, PNG, WebP oder SVG sein, höchstens 8 MB.