Ü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 inexternalIdund verknüpfen Sie bis zu 10 Familien- oder VIP-Tickets über/api/v1/bundlesbzw.PassProjectunter einer gemeinsamenPass.bundleId, damit Gäste alle Tickets mit einem einzigen.pkpasses-Download hinzufügen können. -
Katalog-Demo-Vorlagen:
event-ticketundconference-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:
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 payloadunterstützt nativ optionale HTTPS-,mailto:- undtel:-Links für moderne Apple Event Tickets:bagPolicyURL,orderFoodURL,parkingInformationURL,purchaseParkingURL,directionsInformationURL,contactVenueEmail,contactVenuePhoneNumberundcontactVenueWebsite. -
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 EntscheidungALREADY_USEDab. -
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
/api/v1/scans
{
"scannedBarcodeValue": "TKT-ARENA-90218-A"
}
Beispielhafte Validierungsantwort (200 OK)
{
"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
Aktualisieren Sie die Vorlage oder einzelne Pässe über
PATCH /api/v1/passes/:idbzw. per CSV-Massenupdate. -
2
Ändern Sie das Feld
gateodereventDate. -
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.
