Skip to content
Helpcentrum-gids
3 min leestijdGecontroleerd 2026-11-16

Evenementtickets & check-in

Lever mobiele toegangstickets met stoel-/poortinfo, live programmawijzigingen en snelle toegangscontrole.

In deze gids

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 in externalId en groepeer maximaal 10 familie- of VIP-tickets onder een gedeelde Pass.bundleId via /api/v1/bundles of PassProject, zodat gasten alle tickets met één tik op een .pkpasses-download kunnen toevoegen.
  • Catalogus-demoblauwdrukken: event-ticket en conference-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:

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
TICKETTONING & TOEGANGSCONTROLE BIJ TOURNIQUET
DEELNEMENDE SYSTEEMACTOREN
P1 Locatie-geofence & RelevantDate
P2 Toegangsscherm bezoeker
P3 Tourniquetscanner
P4 Passinstance API
STAP CTX KONTEXT GPS-coörd. / doorsOpen-tijd
STAP 1 VERZOEK / ACTIE Melding op scherm
›
(Native bannermelding)
STAP 2 VERZOEK / ACTIE Toon 2D Aztec
›
(Snelle optische scan)
STAP 3 VERZOEK / ACTIE POST/api/v1/scans
›
Header: x-scanner-key
STAP 4 VERZOEK / ACTIE Check Niet Gebruikt
STAP 5 ANTWOORD 200 OK (ACCEPTED)
›
6. Scanlog vastleggen
›
(Passtatus = USED)
STAP 7 VERZOEK / ACTIE Tourniquet opent

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 payload ondersteunt standaard optionele HTTPS-/mailto-/tel-links die op moderne Apple Event Tickets worden weergegeven: bagPolicyURL, orderFoodURL, parkingInformationURL, purchaseParkingURL, directionsInformationURL, contactVenueEmail, contactVenuePhoneNumber en contactVenueWebsite.
  • 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 beslissing ALREADY_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

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

Voorbeeldrespons voor validatie (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"
    }
  }
}

Realtime pushupdates bij programmawijzigingen

Wanneer het programma uitloopt door het weer, artiesten wisselen of ingangen wijzigen:

  1. 1
    Werk het sjabloon of individuele passen bij via PATCH /api/v1/passes/:id of een CSV-batchupdate.
  2. 2
    Wijzig het veld gate of eventDate.
  3. 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.

Gerelateerde product- en ontwikkelaarsdocs

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.