Vue d'ensemble
Passinstance remplace les pièces jointes PDF statiques et les impressions papier par des billets numériques natifs Event Ticket intégrés à Apple Wallet et Google Wallet. Organisateurs d'événements, festivals de musique, stades sportifs et organisateurs de conférences fluidifient le contrôle d'accès aux entrées, diffusent des annonces d'horaire en temps réel et fournissent des cartes d'orientation directement sur le smartphone des participants.
Architecture backend & types de passes
Dans le backend Passinstance, les billets d'événements s'appuient sur les primitives natives des portefeuilles :
-
Type de passe (pass type) :
eventTicket. -
Variantes de mise en page (theme preference) :
- posterEventTicket : met en œuvre la mise en page événementielle poster d'Apple avec un visuel bord à bord (emplacement artwork) et des métadonnées superposées épurées. - bannerEventTicket : bannière horizontale classique mettant en avant le siège et la porte d'accès.
-
Catégorisation de l'événement (Apple Wallet event type) :
- PKEventTypeLivePerformance : concerts, théâtre, spectacles. - PKEventTypeSports : matchs en stade, tournois. - PKEventTypeConference / PKEventTypeConvention / PKEventTypeWorkshop : sommets sur plusieurs jours, salons professionnels et ateliers. - PKEventTypeMovie : cinémas et festivals de film. - PKEventTypeGeneric / PKEventTypeSocialGathering : entrées générales et rassemblements.
-
Regroupement multi-billets d'une commande (
externalId&bundleId) : enregistrez l'identifiant de ligne de commande de chaque billet dansexternalId, et regroupez jusqu'à 10 billets famille ou VIP sous un mêmePass.bundleIdvia/api/v1/bundlesouPassProjectafin que les invités ajoutent tous leurs billets en un seul clic de téléchargement.pkpasses. -
Modèles de démonstration du catalogue :
event-ticketetconference-badge.
Guide événementiel Apple & intégration MapKit du lieu
Pour les salles de spectacle et grands festivals, les passes Passinstance s'intègrent avec Apple Plans pour afficher une navigation géolocalisée et les services du site :
[ FLUX D'ARCHITECTURE SYSTÈME : AFFICHAGE DU BILLET & CONTRÔLE AU PORTIQUE ]
Géofence site & RelevantDate Écran verrouillé participant Scanner de portique API Passinstance
| | | |
[Coord. GPS / heure portes] | | |
| | | |
|==== 1. Alerte verrouillage>| | |
| (Bannière native) | | |
| |==== 2. Présenter Aztec ==>| |
| | (Scan optique rapide) | |
| | |-- 3. POST /api/v1/scans -->|
| | | En-tête : x-scanner-key |
| | | |-- 4. Vérifier non utilisé
| | |<-- 5. 200 OK (ACCEPTED) ---|-- 6. Journaliser le scan
| | | (Statut passe = USED)
| | |==== 7. Portique déverrouillé|
Guide événementiel & URLs d'action du lieu (request payload)
-
venuePlaceID: identifiant de lieu Apple Plans. Lorsqu'il est renseigné, Apple Wallet affiche un plan interactif du site, des itinéraires de stationnement et les accès en transports en commun. -
venueMap: visuel personnalisé statique indiquant les portes d'entrée, salons VIP, sanitaires et issues de secours. -
Liens d'action associés à l'événement :
request payloadaccepte nativement des liens optionnels HTTPS/mailto/tel affichés sur les billets Apple Event Tickets modernes :bagPolicyURL,orderFoodURL,parkingInformationURL,purchaseParkingURL,directionsInformationURL,contactVenueEmail,contactVenuePhoneNumberetcontactVenueWebsite. -
relevantDate/relevantDates: date(s) ISO 8601 W3C. iOS affiche automatiquement le billet sur l'écran verrouillé du participant à l'approche de l'ouverture des portes. -
Coordonnées de géofencing (
locations) : les coordonnées latitude/longitude autour de l'enceinte déclenchent l'affichage sur l'écran verrouillé dès l'arrivée des spectateurs sur place.
Moteur de validation aux portiques et entrées
Les contrôles à fort débit nécessitent une validation rapide et résiliente aux pertes réseau :
Modes du scanner (ScanMode)
-
CHECK_IN: marque le billet comme scanné pour l'entrée. S'il est présenté une seconde fois au portique, le moteur rejette le billet avec la décisionALREADY_USED. -
CHECK_OUT: gère les sorties temporaires (zones fumeurs ou pauses déjeuner) avec ré-entrée ultérieure. -
SAVE_ATTENDANCE: enregistre la participation aux sessions (idéal pour les salles d'ateliers d'une conférence multi-parcours).
Exemple de requête de validation de scan
/api/v1/scans
{
"scannedBarcodeValue": "TKT-ARENA-90218-A"
}
Exemple de réponse de validation (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"
}
}
}
Mises à jour push d'horaire en temps réel
En cas de retard météo, de changement d'artiste ou de modification de porte d'accès :
-
1
Mettez à jour le modèle ou les billets individuels via
PATCH /api/v1/passes/:idou par mise à jour CSV en lot. -
2
Modifiez le champ
gateoueventDate. -
3
Apple Wallet et Google Wallet reçoivent les mises à jour instantanément :
- Apple Wallet affiche une bannière sur l'écran verrouillé : « Porte modifiée : Porte D » (via changeMessage: "Porte modifiée : %@"). - Google Wallet actualise le widget en direct de la carte et notifie le participant.
Prérequis : Utilisez les symbologies 2D Aztec (
PKBarcodeFormatAztec) ou QR (PKBarcodeFormatQR) pour vos billets d'événements. Les codes Aztec offrent une forte correction d'erreurs et se lisent très rapidement sur les lecteurs laser optiques et caméras, même sur des écrans de téléphone à faible luminosité.
Consultez notre Cas d'usage Billets d'événements et Événementiel & Billetterie.
