Overzicht
Passinstance vervangt statische pdf-bijlagen en papieren afdrukken door native digitale Event Ticket-passen in Apple Wallet en Google Wallet. Evenementorganisatoren, muziekfestivals, sportstadions en conferentieproducenten leveren snelle poorttoegang, realtime programma-aankondigingen en locatiekaarten rechtstreeks op de smartphones van bezoekers.
Backendarchitectuur & pastypen
In de Passinstance-backend worden evenementtickets gemodelleerd met native wallet-primitieven:
-
Pastype (pass type):
eventTicket. -
Lay-outvarianten (theme preference):
- posterEventTicket: Implementeert Apple's posterevenementlay-out met een randloze afbeelding (artwork-assetpositie) en overzichtelijke metadata-overlays. - bannerEventTicket: Klassieke horizontale stripbanner met opvallende stoel- en poortgegevens.
-
Evenementcategorisatie (Apple Wallet event type):
- PKEventTypeLivePerformance: Concerten, theater, cabaret. - PKEventTypeSports: Stadionwedstrijden, toernooien. - PKEventTypeConference / PKEventTypeConvention / PKEventTypeWorkshop: Meerdaagse congressen, beurzen en workshops. - PKEventTypeMovie: Bioscopen en filmfestivals. - PKEventTypeGeneric / PKEventTypeSocialGathering: Algemene toegang en sociale bijeenkomsten.
-
Groepering van meerdere tickets per bestelling (
externalId&bundleId): Sla het externe orderregel-ID van elk ticket op inexternalIden groepeer maximaal 10 familie- of VIP-tickets onder een gedeeldePass.bundleIdvia/api/v1/bundlesofPassProject, zodat gasten alle tickets met één tik op een.pkpasses-download kunnen toevoegen. -
Catalogus-demoblauwdrukken:
event-ticketenconference-badge.
Apple Event Guide & MapKit-locatie-integratie
Voor stadions, zalen en grote festivals integreren Passinstance-passen met Apple Kaarten om gelokaliseerde navigatie en locatievoorzieningen te tonen:
Event Guide & locatie-actie-URL's (request payload)
-
venuePlaceID: Apple Maps Place Identifier. Indien aanwezig toont Apple Wallet een interactieve locatiekaart, parkeeraanwijzingen en ov-links. -
venueMap: Aangepaste statische afbeelding die ingangen, VIP-lounges, toiletten en nooduitgangen weergeeft. -
Aanvullende actie-links voor evenementen:
request payloadondersteunt standaard optionele HTTPS-/mailto-/tel-links die op moderne Apple Event Tickets worden weergegeven:bagPolicyURL,orderFoodURL,parkingInformationURL,purchaseParkingURL,directionsInformationURL,contactVenueEmail,contactVenuePhoneNumberencontactVenueWebsite. -
relevantDate/relevantDates: W3C ISO 8601-datum(s). iOS toont de evenementpas automatisch op het toegangsscherm van de gebruiker vlak voordat de deuren opengaan. -
Geofencingcoördinaten (
locations): Breedte- en lengtegraadcoördinaten rond de locatie activeren weergave op het toegangsscherm zodra bezoekers ter plaatse aankomen.
Validatie-engine voor tourniquets & ingangen
Drukke ingangen vereisen snelle validatie die ook bij wisselende netwerkdekking betrouwbaar blijft:
Scannermodi (ScanMode)
-
CHECK_IN: Markeert het ticket als gescand voor toegang. Als hetzelfde ticket opnieuw wordt aangeboden bij een tourniquet, weigert de engine het ticket met beslissingALREADY_USED. -
CHECK_OUT: Ondersteunt tijdelijk verlaten van de locatie voor rookzones of pauzes. -
SAVE_ATTENDANCE: Registreert aanwezigheid per sessie (ideaal voor parallelle break-outzalen op congressen).
Voorbeeldverzoek voor scanvalidatie
/api/v1/scans
{
"scannedBarcodeValue": "TKT-ARENA-90218-A"
}
Voorbeeldrespons voor validatie (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"
}
}
}
Realtime pushupdates bij programmawijzigingen
Wanneer het programma uitloopt door het weer, artiesten wisselen of ingangen wijzigen:
-
1
Werk het sjabloon of individuele passen bij via
PATCH /api/v1/passes/:idof een CSV-batchupdate. -
2
Wijzig het veld
gateofeventDate. -
3
Apple Wallet en Google Wallet ontvangen directe updates:
- Apple Wallet toont een melding op het toegangsscherm: "Poort gewijzigd naar Gate D" (via changeMessage: "Poort gewijzigd naar %@"). - Google Wallet werkt de live kaartwidget bij en brengt de gebruiker op de hoogte.
Vereisten: Gebruik 2D-barcodesymbologieën Aztec (
PKBarcodeFormatAztec) of QR (PKBarcodeFormatQR) voor evenementtickets. Aztec-barcodes bieden sterke foutcorrectie en kunnen razendsnel worden uitgelezen door optische lasers en camerascanners, zelfs op gedimde telefoonschermen.
Bekijk onze Use-case voor evenementtickets en Evenementen & ticketing.
