Skip to content
Guide du centre d'aide
4 min de lectureVérifié 2026-11-16

Billets d'événements & contrôle d'entrée

Livrez des billets mobiles incluant place/porte, mises à jour d'horaire en direct et scan d'entrée rapide.

Dans ce guide

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 dans externalId, et regroupez jusqu'à 10 billets famille ou VIP sous un même Pass.bundleId via /api/v1/bundles ou PassProject afin 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-ticket et conference-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 :

TEXT
[ 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 payload accepte nativement des liens optionnels HTTPS/mailto/tel affichés sur les billets Apple Event Tickets modernes : bagPolicyURL, orderFoodURL, parkingInformationURL, purchaseParkingURL, directionsInformationURL, contactVenueEmail, contactVenuePhoneNumber et contactVenueWebsite.
  • 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écision ALREADY_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

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

Exemple de réponse de validation (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"
    }
  }
}

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. 1
    Mettez à jour le modèle ou les billets individuels via PATCH /api/v1/passes/:id ou par mise à jour CSV en lot.
  2. 2
    Modifiez le champ gate ou eventDate.
  3. 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.

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.