Skip to content
Hilfecenter-Anleitung
3 Min. LesezeitGeprüft 2026-11-16

Event-Tickets & Check-in

Versenden Sie mobile Eintrittskarten mit Sitzplatz- und Zugangsdaten, Live-Zeitplanaktualisierungen und schnellem Einlass-Scan.

In dieser Anleitung

Überblick

Passinstance ersetzt statische PDF-Anhänge und Papierausdrucke durch native digitale Event-Ticket-Pässe in Apple Wallet und Google Wallet. Veranstaltungsagenturen, Musikfestivals, Sportarenen und Konferenzorganisatoren profitieren von schnellem Einlass mit hohem Durchsatz, Live-Ankündigungen bei Programmänderungen und integrierten Veranstaltungsort-Karten direkt auf dem Smartphone der Gäste.

Backend-Architektur & Pass-Typen

Im Passinstance-Backend werden Event-Tickets über native Wallet-Primitive modelliert:

  • Pass-Typ (pass type): eventTicket.
  • Layout-Varianten (theme preference):

- posterEventTicket: Setzt Apples modernes Poster-Event-Layout mit randabfallender Grafik (artwork-Asset-Slot) und klaren Metadaten-Overlays um. - bannerEventTicket: Klassisches horizontales Strip-Banner mit gut sichtbaren Sitzplatz- und Eingangsdaten.

  • Event-Kategorisierung (Apple Wallet event type):

- PKEventTypeLivePerformance: Konzerte, Theater, Comedy. - PKEventTypeSports: Stadienspiele, Turniere. - PKEventTypeConference / PKEventTypeConvention / PKEventTypeWorkshop: Mehrtägige Kongresse, Messen und Workshops. - PKEventTypeMovie: Kinos und Filmfestivals. - PKEventTypeGeneric / PKEventTypeSocialGathering: Allgemeiner Einlass und gesellschaftliche Veranstaltungen.

  • Bündelung mehrerer Tickets pro Bestellung (externalId & bundleId): Speichern Sie die externe Bestellpositions-ID jedes Tickets in externalId und verknüpfen Sie bis zu 10 Familien- oder VIP-Tickets über /api/v1/bundles bzw. PassProject unter einer gemeinsamen Pass.bundleId, damit Gäste alle Tickets mit einem einzigen .pkpasses-Download hinzufügen können.
  • Katalog-Demo-Vorlagen: event-ticket und conference-badge.

Apple Event Guide & MapKit-Integration für Veranstaltungsorte

Für Stadien, Hallen und große Festivals lassen sich Passinstance-Pässe mit Apple Maps verbinden, um lokale Navigation und Besucherinformationen anzuzeigen:

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
TICKET-ANZEIGE & DREHKREUZ-EINLASS
BETEILIGTE SYSTEMKOMPONENTEN
P1 Venue Geofence & RelevantDate
P2 Sperrbildschirm des Gasts
P3 Drehkreuz-Scanner
P4 Passinstance API
SCHRITT CTX KONTEXT GPS-Koord. / Einlasszeit
SCHRITT 1 ANFRAGE / AKTION Sperrbildschirm
›
(Natives Banner)
SCHRITT 2 ANFRAGE / AKTION 2D-Aztec zeigen
›
(Schneller Opt.-Scan)
SCHRITT 3 ANFRAGE / AKTION POST/api/v1/scans
›
Header: x-scanner-key
SCHRITT 4 ANFRAGE / AKTION Unbenutzt prüfen
SCHRITT 5 ANTWORT 200 OK (ACCEPTED)
›
6. Scan speichern
›
(Pass-Status = USED)
SCHRITT 7 ANFRAGE / AKTION Drehkreuz öffnet

Event Guide & Aktions-URLs für Veranstaltungsorte (request payload)

  • venuePlaceID: Apple Maps Place Identifier. Wenn hinterlegt, zeigt Apple Wallet eine interaktive Karte des Veranstaltungsortes, Parkhinweise und ÖPNV-Verbindungen an.
  • venueMap: Eigene statische Grafik mit Eingängen, VIP-Lounges, Sanitäranlagen und Notausgängen.
  • Begleitende Event-Aktionslinks: request payload unterstützt nativ optionale HTTPS-, mailto:- und tel:-Links für moderne Apple Event Tickets: bagPolicyURL, orderFoodURL, parkingInformationURL, purchaseParkingURL, directionsInformationURL, contactVenueEmail, contactVenuePhoneNumber und contactVenueWebsite.
  • relevantDate / relevantDates: W3C-ISO-8601-Datum/-Daten. iOS blendet das Ticket kurz vor Einlass automatisch auf dem Sperrbildschirm ein.
  • Geofencing-Koordinaten (locations): Längen- und Breitengrade rund um das Gelände lösen die Anzeige auf dem Sperrbildschirm aus, sobald Gäste vor Ort eintreffen.

Drehkreuz- & Einlass-Validierungs-Engine

Eingänge mit hoher Besucherfrequenz erfordern schnelle, auch bei Netzschwankungen zuverlässige Prüfungen:

Scanner-Modi (ScanMode)

  • CHECK_IN: Markiert das Ticket beim Einlass als gescannt. Bei erneutem Vorzeigen an einem Drehkreuz lehnt die Engine das Ticket mit der Entscheidung ALREADY_USED ab.
  • CHECK_OUT: Ermöglicht vorübergehendes Verlassen des Geländes (z. B. Pausen- oder Raucherbereiche).
  • SAVE_ATTENDANCE: Protokolliert Session-Teilnahmen (ideal für parallele Vortragsräume auf Konferenzen).

Beispiel einer Scan-Validierungsanfrage

POST /api/v1/scans
Header
x-scanner-key sk_live_gate_turnstile_02
Content-Type application/json
JSON
{
  "scannedBarcodeValue": "TKT-ARENA-90218-A"
}

Beispielhafte Validierungsantwort (200 OK)

JSON
{
  "decision": "SUCCESS",
  "status": "ACCEPTED",
  "passSnapshot": {
    "id": "pass_tkt_90218",
    "templateId": "tmpl_event_5521",
    "serialNumber": "TKT-ARENA-90218-A",
    "status": "ACTIVE",
    "attributes": {
      "section": "104",
      "row": "F",
      "seat": "18",
      "gate": "Gate C"
    }
  }
}

Push-Updates für Zeitpläne in Echtzeit

Bei Wetterverzögerungen, geänderten Auftrittszeiten oder verlegten Eingängen:

  1. 1
    Aktualisieren Sie die Vorlage oder einzelne Pässe über PATCH /api/v1/passes/:id bzw. per CSV-Massenupdate.
  2. 2
    Ändern Sie das Feld gate oder eventDate.
  3. 3
    Apple Wallet und Google Wallet erhalten umgehend Updates:

- Apple Wallet zeigt eine Sperrbildschirm-Meldung an: „Gate geändert auf Gate D“ (über changeMessage: "Gate geändert auf %@"). - Google Wallet aktualisiert das Live-Karten-Widget und benachrichtigt den Gast.

Voraussetzungen: Nutzen Sie für Event-Tickets die 2D-Barcode-Symbologien Aztec (PKBarcodeFormatAztec) oder QR (PKBarcodeFormatQR). Aztec-Barcodes bieten eine hohe Fehlerkorrektur und lassen sich von optischen Laser- und Kamera-Scannern selbst auf abgedimmten Smartphone-Displays extrem schnell erfassen.

Entdecken Sie unseren Anwendungsfall Event-Tickets sowie die Branchenlösung Events & Ticketing.

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.