Billets de cinéma dans Apple Wallet et Google Wallet

Le spectateur achète sa place dans le métro, arrive cinq minutes avant la séance et cherche son email. Avec un billet dans Apple Wallet ou Google Wallet, il ouvre son écran de verrouillage et passe. Salle, rang et place sont affichés en grand. Après le film, un coupon confiserie ou une invitation à la prochaine avant-première le fait revenir.

📲Essayez ce pass en directRemplissez le formulaire, voyez le pass et le code se mettre à jour, puis recevez-le sur votre téléphone.→

Le parcours client

Workflow d'intégration

1. Créer la séanceVotre serveur

   Une séance est un événement : film en name, synopsis en description, horaires de début et de fin, prix, conditions, adresse du cinéma et affiche en strip. Les trois libellés de placement deviennent Salle (ZONE à gauche), Rang (ROW au centre) et Place (SEAT à droite). Créez-la automatiquement depuis votre programmation.

   POST/eventsEssayer →

   • curl
   • SDK Node.js
   • nodejs
   • php
   • python
   • java
   • csharp
   • go
   • ruby

   • CURL

   curl -L 'https://api-v2.test.eldowallet.fr/events' \
   -H 'Accept: application/json' \
   -H 'x-lang: fr' \
   -H 'Authorization: Bearer <token>' \
   -F 'strip=@"affiche.jpg"' \
   -F 'name="Séance 20:45"' \
   -F 'barcodeType="QR_CODE"' \
   -F 'date="{\"startDate\":\"2026-11-14T19:45:00.000Z\",\"endDate\":\"2026-11-14T22:00:00.000Z\"}"' \
   -F 'PKTextAlignmentLeft="ZONE"' \
   -F 'PKTextAlignmentCenter="ROW"' \
   -F 'PKTextAlignmentRight="SEAT"' \
   -F 'colors="{\"backgroundColor\":\"\#2b1a0f\",\"labelColor\":\"\#ffb648\",\"foregroundColor\":\"\#ffffff\"}"' \
   -F 'security="{\"enableOneTimeUse\":true}"'

   POST/events
2. Émettre le billet après l'achatVotre serveur

   Un appel par place vendue, avec la salle, le rang et la place. Une réservation de groupe ? Émettez en lot.

   POST/events/{id}/passesEssayer →

   • curl
   • SDK Node.js
   • nodejs
   • php
   • python
   • java
   • csharp
   • go
   • ruby

   • CURL

   curl -L 'https://api-v2.test.eldowallet.fr/events/$EVENT_ID/passes' \
   -H 'Accept: application/json' \
   -H 'Content-Type: application/json' \
   -H 'x-lang: fr' \
   -H 'Authorization: Bearer <token>' \
   --data-raw '{
     "firstName": "Hugo",
     "lastName": "Lefèvre",
     "email": "hugo.lefevre@example.com",
     "leftRow": "7",
     "centerRow": "H",
     "rightRow": "12"
   }'

   POST/events/{id}/passesPOST/events/{id}/passes/bulk
3. Le spectateur ajoute son billetClient final

   Le billet est hors ligne et prêt à scanner.

4. Valider à l'entréeVotre serveur

   Le contrôleur scanne le billet, le pass est validé. Un scan par erreur se corrige en annulant la validation.

   POST/passes/template/{templateId}/redeem/{barcode}POST/passes/template/{templateId}/unredeem/{barcode}
5. Faire revenir le spectateurVotre serveur

   Créez un coupon « -2 € sur le menu popcorn » ou « place à 6 € le mardi » et envoyez-le après la séance, même à un spectateur qui n'est pas encore client (prénom, nom, email).

   POST/couponsPOST/coupons/{id}/passes/send

Bonnes pratiques

• Une séance, un événement. Le même film à 18:00 et à 20:45 donne deux événements, chacun avec son horaire. Réutilisez l'affiche.
• Utilisez l'affiche comme strip. Le spectateur reconnaît son film d'un coup d'œil. Voir Recommandations visuelles.
• Activez l'usage unique pour bloquer la seconde entrée avec une capture d'écran.
• Déclarez la localisation du cinéma pour que le billet remonte à l'arrivée. Voir Localisations.

Pour aller plus loin

• Événements & salons
• Retail & mode pour la mécanique des coupons
• Cycle de vie d'un pass
• Endpoints : POST/events POST/events/{id}/passes POST/passes/template/{templateId}/redeem/{barcode}

Pour vous inspirer

Le billet de cinéma peut faire revenir le spectateur bien plus souvent. Voici des idées pour y parvenir.

⏰La séance commence bientôt30 minutes avant la séance : salle, horaire du film après les bandes-annonces et offre confiserie à retirer en arrivant.

🎫Carte multi-séancesUne carte de 5 ou 10 places affiche le nombre de séances restantes, mis à jour à chaque passage.

🌟Avant-premièreLes spectateurs fidèles reçoivent une invitation nominative à une avant-première, scannée à l’entrée.

🍿Le film que vous attendiezLe spectateur a aimé un film ? Prévenez-le à la sortie de la suite ou d’un film du même genre, avec un lien de réservation.

🎂Une place pour votre anniversaireLe mois de son anniversaire, le spectateur reçoit une place offerte ou à prix réduit.

👨‍👩‍👧Vacances en famillePendant les vacances scolaires, un tarif famille pour les séances jeune public, envoyé aux parents.

🅿️Parking à tarif réduitLe billet donne droit à un tarif réduit au parking voisin, sur simple présentation.

⭐Notez le filmLe lendemain, un message invite le spectateur à noter le film et la salle. Des avis frais pour votre programmation.

Une de ces idées vous parle ? Contactez notre équipe : nous vous montrons comment la mettre en place.