Billets d'événement dans Apple Wallet et Google Wallet

Un billet PDF se perd dans la boîte mail. Un billet Apple Wallet ou Google Wallet remonte tout seul sur l'écran de verrouillage le jour J, à l'approche de la salle. Vous émettez le billet à l'achat, vous le mettez à jour si la date ou la salle change, et vous le validez à l'entrée. Le spectateur n'a rien à chercher.

📲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 l'événementBack-office

   L'événement est le modèle commun à tous les billets : nom, description, dates de début et de fin, ouverture des portes, prix, conditions, contact, site web, couleurs et strip officiel. Ajoutez la localisation de la salle pour que le billet remonte à l'approche. Choisissez enfin les trois libellés de placement : gauche (ZONE, ACCESS…), centre (ROW), droite (SEAT, PLACE…).

   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=@"salon-tech.png"' \
   -F 'name="Salon Tech 2026"' \
   -F 'description="Le salon des technologies, 3 halls, 200 exposants."' \
   -F 'barcodeType="QR_CODE"' \
   -F 'date="{\"startDate\":\"2026-11-12T09:00:00.000Z\",\"endDate\":\"2026-11-12T18:00:00.000Z\",\"doorOpeningHour\":\"2026-11-12T08:30:00.000Z\"}"' \
   -F 'locations="[{\"latitude\":48.8323,\"longitude\":2.2875,\"address\":\"1 place de la Porte de Versailles, 75015 Paris\",\"locationName\":\"Paris Expo\"}]"' \
   -F 'PKTextAlignmentLeft="ZONE"' \
   -F 'PKTextAlignmentCenter="INACTIVE"' \
   -F 'PKTextAlignmentRight="TYPE"' \
   -F 'colors="{\"backgroundColor\":\"\#131313\",\"labelColor\":\"\#9ee00d\",\"foregroundColor\":\"\#ffffff\"}"' \
   -F 'security="{\"enableOneTimeUse\":true,\"enableRotatingBarcode\":true}"'

   POST/events
2. Émettre le billet à l'achatVotre serveur

   Votre billetterie appelle eldo wallet pour chaque billet, avec l'identité du spectateur et les trois valeurs de placement. Si le spectateur est déjà client de votre wallet, passez aussi son clientId.

   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": "Sarah",
     "lastName": "Petit",
     "email": "sarah.petit@example.com",
     "leftRow": "Hall B",
     "rightRow": "VIP",
     "barcode": "ST26-000481"
   }'

   POST/events/{id}/passes
3. Émettre en lotVotre serveur

   Presse, invités sponsors, comités d'entreprise : jusqu'à 5 000 billets en une requête, traités en asynchrone. Voir Envoyer à des non-clients.

   POST/events/{id}/passes/bulkGET/bulk-operations/{operationId}
4. Le spectateur ajoute son billetClient final

   Le billet est disponible hors ligne et survit au changement de téléphone.

5. Reporter, changer de salleVotre serveur

   Un appel sur l'événement met à jour tous les billets émis : nouvelle date, nouvelle adresse, nouveau visuel. Un seul spectateur change de place ? Mettez à jour son billet.

   PATCH/events/{id}PATCH/events/{id}/passes/{passId}
6. Contrôler l'accèsVotre serveur

   La douchette scanne le QR. Retrouvez le billet par son code-barres, affichez le placement, puis validez. Un second scan renvoie PASS_ALREADY_REDEEMED. Erreur de scan ? Annulez la validation.

   POST/passes/template/{templateId}/redeem/{barcode}Essayer →

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

   • CURL

   curl -L -X POST 'https://api-v2.test.eldowallet.fr/passes/template/$EVENT_ID/redeem/ST26-000481' \
   -H 'Accept: application/json' \
   -H 'x-lang: fr' \
   -H 'Authorization: Bearer <token>'

   GET/events/{id}/passes/barcode/{barcode}POST/passes/template/{templateId}/redeem/{barcode}POST/passes/template/{templateId}/unredeem/{barcode}
7. Suivre la fréquentationVotre serveur

   Listez les billets de l'événement et leur statut pour suivre les entrées en temps réel.

   GET/events/{id}/passes

Bonnes pratiques

• Un événement par séance. Une tournée de dix dates, c'est dix événements. Réutilisez le même visuel.
• Activez l'usage unique et le code-barres rotatif sur les événements à forte valeur. Les options de sécurité limitent la revente et les captures d'écran.
• Déclarez l'emplacement de la salle. C'est ce qui fait apparaître le billet sur l'écran de verrouillage. Voir Localisations.
• Multipart : objets en chaîne JSON. date, locations, colors et security partent en chaîne JSON dans le formulaire. C'est l'erreur la plus fréquente.
• Testez le flux de scan en conditions réelles avant l'ouverture des portes : débit, luminosité, réseau dans la salle.

Pour aller plus loin

• Sport & clubs pour les billets de match
• Cinéma
• Cycle de vie d'un pass
• Endpoints : POST/events POST/events/{id}/passes PATCH/events/{id} POST/passes/template/{templateId}/redeem/{barcode}

Pour vous inspirer

Un billet Wallet peut accompagner le spectateur avant, pendant et après l’événement. Voici des idées pour aller plus loin.

🚪Les portes ouvrent« Les portes sont ouvertes, l’entrée C est la plus rapide. » Un message au bon moment fluidifie l’arrivée du public.

🅿️Parking et navettesLe billet s’accompagne d’un ticket de parking ou de navette, avec le plan d’accès au verso.

🎤Le mot de l’artisteJuste avant le début, un message de bienvenue de l’artiste ou de l’organisateur. Le public s’en souvient.

🍻Offre bar et merchandisingPendant l’entracte, une réduction au bar ou au stand de merchandising, à présenter en caisse.

🗓️Programme du jourSalons et conférences : le programme au verso du billet, et un rappel avant les temps forts.

📸Photos et replayAprès l’événement, le billet devient un souvenir : lien vers les photos, le replay ou les présentations.

🎟️Prévente réservéeLes spectateurs de cette édition accèdent en premier à la billetterie de la suivante, avec un lien dédié.

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