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 (
externalIdebundleId): Salvi l'ID riga ordine esterno di ciascun biglietto inexternalIde raggruppi fino a 10 biglietti famiglia o VIP in unPass.bundleIdcondiviso tramite/api/v1/bundlesoPassProject, consentendo agli ospiti di aggiungere tutti i biglietti con un solo tocco tramite archivio.pkpasses. -
Modelli demo a catalogo:
event-ticketeconference-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:
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 payloadaccetta nativamente link opzionali HTTPS/mailto/tel visualizzati sui moderni Apple Event Ticket:bagPolicyURL,orderFoodURL,parkingInformationURL,purchaseParkingURL,directionsInformationURL,contactVenueEmail,contactVenuePhoneNumberecontactVenueWebsite. -
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 decisioneALREADY_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
/api/v1/scans
{
"scannedBarcodeValue": "TKT-ARENA-90218-A"
}
Esempio di risposta alla validazione (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"
}
}
}
Aggiornamenti push in tempo reale sugli orari
In caso di ritardi meteo, cambi di artista o variazioni di varco:
-
1
Aggiorni il modello oppure i singoli pass tramite
PATCH /api/v1/passes/:ido aggiornamento batch CSV. -
2
Modifichi il campo
gateoeventDate. -
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.
