Skip to content
Guida del Centro assistenza
3 min di letturaVerificato 2026-11-16

Biglietti eventi e check-in

Consegna biglietti mobili con settore/posto, aggiornamenti orario in tempo reale e controllo rapido all'ingresso.

In questa guida

Panoramica

Passinstance sostituisce gli allegati PDF statici e le stampe cartacee con biglietti digitali nativi Event Ticket in Apple Wallet e Google Wallet. Organizzatori di eventi, festival musicali, stadi sportivi e responsabili di conferenze offrono ingressi ad alta velocità ai varchi, comunicazioni in tempo reale sui cambi di programma e mappe della sede direttamente sullo smartphone dei partecipanti.

Architettura backend e tipi di pass

Nel backend di Passinstance, i biglietti per eventi sono modellati mediante primitive Wallet native:

  • Tipo di pass (pass type): eventTicket.
  • Varianti di layout (theme preference):

- posterEventTicket: Implementa il layout poster per eventi di Apple con grafica edge-to-edge (slot asset artwork) e sovrapposizioni pulite dei metadati. - bannerEventTicket: Classico banner orizzontale strip con informazioni in evidenza su posto e varco.

  • Categorizzazione eventi (Apple Wallet event type):

- PKEventTypeLivePerformance: Concerti, teatro, spettacoli comici. - PKEventTypeSports: Partite allo stadio, tornei. - PKEventTypeConference / PKEventTypeConvention / PKEventTypeWorkshop: Summit multi-giorno, fiere e workshop. - PKEventTypeMovie: Cinema e festival cinematografici. - PKEventTypeGeneric / PKEventTypeSocialGathering: Ingresso generale ed eventi sociali.

  • Raggruppamento ordini multi-biglietto (externalId e bundleId): Salvi l'ID riga ordine esterno di ciascun biglietto in externalId e raggruppi fino a 10 biglietti famiglia o VIP in un Pass.bundleId condiviso tramite /api/v1/bundles o PassProject, consentendo agli ospiti di aggiungere tutti i biglietti con un solo tocco tramite archivio .pkpasses.
  • Modelli demo a catalogo: event-ticket e conference-badge.

Guida eventi Apple e integrazione sedi MapKit

Per grandi venue e festival, i pass Passinstance si integrano con Apple Maps per mostrare indicazioni contestuali e servizi dell'evento:

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
EMERSIONE BIGLIETTO E ACCESSO AL TORNELLO
ATTORI DI SISTEMA COINVOLTI
P1 Geofence sede e RelevantDate
P2 Schermata blocco ospite
P3 Scanner tornello
P4 Passinstance API
FASE CTX CONTESTO Coordinate GPS / orario apertura
FASE 1 RICHIESTA / AZIONE Comparsa su blocco
›
(Banner nativo iOS)
FASE 2 RICHIESTA / AZIONE Mostra Aztec 2D
›
(Scansione ottica)
FASE 3 RICHIESTA / AZIONE POST/api/v1/scans
›
Header: x-scanner-key
FASE 4 RICHIESTA / AZIONE Verifica non usato
FASE 5 RISPOSTA 200 OK (ACCEPTED)
›
6. Registra log scan
›
(Stato Pass = USED)
FASE 7 RICHIESTA / AZIONE Sblocca tornello

Guida eventi e URL di azione della sede (request payload)

  • venuePlaceID: Identificativo luogo di Apple Maps. Quando presente, Apple Wallet mostra una mappa interattiva della sede, indicazioni per il parcheggio e collegamenti ai trasporti pubblici.
  • venueMap: Risorsa immagine statica personalizzata che mostra varchi d'ingresso, aree VIP, servizi igienici e uscite di emergenza.
  • Link di azione per l'evento: request payload accetta nativamente link opzionali HTTPS/mailto/tel visualizzati sui moderni Apple Event Ticket: bagPolicyURL, orderFoodURL, parkingInformationURL, purchaseParkingURL, directionsInformationURL, contactVenueEmail, contactVenuePhoneNumber e contactVenueWebsite.
  • relevantDate / relevantDates: Date in formato W3C ISO 8601. iOS mostra automaticamente il biglietto nella schermata di blocco dell'utente in prossimità dell'apertura delle porte.
  • Coordinate geofencing (locations): Latitudine e longitudine attorno alla sede attivano la visualizzazione nella schermata di blocco all'arrivo dei partecipanti sul posto.

Motore di validazione per tornelli e varchi

I varchi ad alto afflusso richiedono validazioni rapide e resistenti alla disconnessione:

Modalità scanner (ScanMode)

  • CHECK_IN: Contrassegna il biglietto come scansionato per l'ingresso. Se ripresentato a un tornello, il motore rifiuta il biglietto con decisione ALREADY_USED.
  • CHECK_OUT: Supporta l'uscita temporanea dall'area evento (es. area fumatori o pausa pranzo).
  • SAVE_ATTENDANCE: Registra la presenza alle singole sessioni (ideale per sale tematiche in conferenze multi-traccia).

Esempio di richiesta di validazione scansione

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

Esempio di risposta alla validazione (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"
    }
  }
}

Aggiornamenti push in tempo reale sugli orari

In caso di ritardi meteo, cambi di artista o variazioni di varco:

  1. 1
    Aggiorni il modello oppure i singoli pass tramite PATCH /api/v1/passes/:id o aggiornamento batch CSV.
  2. 2
    Modifichi il campo gate o eventDate.
  3. 3
    Apple Wallet e Google Wallet ricevono aggiornamenti immediati:

- Apple Wallet mostra un avviso sulla schermata di blocco: "Gate changed to Gate D" (tramite changeMessage: "Gate changed to %@"). - Google Wallet aggiorna il widget live della tessera e invia una notifica all'utente.

Prerequisiti: Utilizzi simbologie a codice a barre 2D Aztec (PKBarcodeFormatAztec) o QR (PKBarcodeFormatQR) per i biglietti evento. I codici Aztec integrano un'elevata correzione d'errore e vengono decodificati rapidamente da lettori ottici laser e fotocamere anche su schermi poco luminosi.

Esplori il nostro Caso d'uso Biglietti eventi e Eventi e biglietteria.

Documentazione prodotto e API correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.