Titres de transport dans Apple Wallet et Google Wallet

Quand vous vendez du voyage, votre client a besoin d'une seule chose : le bon billet, au bon moment, sans stress. eldo wallet pose le titre de transport dans son téléphone, dans Apple Wallet ou Google Wallet, dès la réservation. Il est disponible hors ligne, remonte sur l'écran de verrouillage le jour du départ et se met à jour tout seul quand l'horaire change.

📲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 le modèle de liaisonBack-office

   Un modèle de transit regroupe ce qui est commun à tous les billets d'une liaison : type (Bus, Train, Tram, Boat, Air, Generic), gares et codes, horaires de référence, tarif, conditions, numéro du service client, couleurs, strip et format de code-barres. Créez-le une fois, dans le back-office ou par l'API. Le wallet doit avoir le type de pass TRANSIT activé.

   POST/transitsEssayer →

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

   • CURL

   curl -L 'https://api-v2.test.eldowallet.fr/transits' \
   -H 'Accept: application/json' \
   -H 'x-lang: fr' \
   -H 'Authorization: Bearer <token>' \
   -F 'strip=@"bandeau.png"' \
   -F 'type="Bus"' \
   -F 'number="147"' \
   -F 'originStationCode="MLH"' \
   -F 'originName="Mulhouse"' \
   -F 'destinationStationCode="GVA"' \
   -F 'destinationName="Genève"' \
   -F 'departureTime="09:30"' \
   -F 'arrivalTime="12:15"' \
   -F 'details="Présentez-vous 15 minutes avant le départ."' \
   -F 'terms="Billet nominatif, échangeable jusqu'\''à la veille."' \
   -F 'barcodeFormat="QR_CODE"' \
   -F 'colors="{\"backgroundColor\":\"\#0f3d5e\",\"labelColor\":\"\#9ee00d\",\"foregroundColor\":\"\#ffffff\"}"' \
   -F 'security="{\"enableOneTimeUse\":true,\"disableIOSPassSharing\":true}"'

   POST/transitsPATCH/transits/{id}
2. Le voyageur réserveClient final

   Sur votre site, votre application, au guichet ou chez un revendeur. Votre billettique enregistre la vente, puis appelle eldo wallet.

3. Émettre le billetVotre serveur

   Un appel par voyageur, avec ses coordonnées, les dates, le code-barres et surtout le tripNumber. Ce numéro regroupe tous les billets d'un même service : c'est lui qui rend possibles les mises à jour groupées.

   Deux options de distribution :

   • enableSendEmailOrSms: true : eldo wallet envoie l'email ou le SMS avec le bouton « Ajouter au Wallet ».
   • enableSendEmailOrSms: false : vous récupérez le lien dans la réponse et le diffusez vous-même (email de confirmation, application, QR sur un ticket d'agence ou une borne).

   POST/transits/{transitId}/passesEssayer →

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

   • CURL

   curl -L 'https://api-v2.test.eldowallet.fr/transits/$TRANSIT_ID/passes' \
   -H 'Accept: application/json' \
   -H 'Content-Type: application/json' \
   -H 'x-lang: fr' \
   -H 'Authorization: Bearer <token>' \
   --data-raw '{
     "firstName": "Loïc",
     "lastName": "Bernard",
     "email": "loic.bernard@example.com",
     "departureDate": "2026-11-12",
     "arrivalDate": "2026-11-12",
     "departureTime": "09:30",
     "arrivalTime": "12:15",
     "tripNumber": "MLH-GVA-20261112-0930",
     "seat": "14",
     "barcode": "TR-2026-000123",
     "expirationDate": "2026-11-13T00:00:00.000Z",
     "enableSendEmailOrSms": true
   }'

   POST/transits/{transitId}/passes
4. Émettre en lotVotre serveur

   Groupes scolaires, comités d'entreprise, affrètements : envoyez jusqu'à 5 000 billets en une requête. L'opération est asynchrone. Suivez son statut par son identifiant, ou passez un webhookUrl pour être prévenu à la fin.

   POST/transits/{transitId}/passes/bulkGET/bulk-operations/{operationId}
5. Prévenir d'un retard ou d'un changementVotre serveur

   Un appel met à jour tous les billets du trajet (horaires, gares, dates). Pour expliquer le contexte (« Retard 30 min, météo »), envoyez en plus un message aux porteurs du tripNumber. Guide complet : Mettre à jour un trajet.

   PATCH/transits/{transitId}/passes/trip/{tripNumber}Essayer →

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

   • CURL

   curl -L -X PATCH 'https://api-v2.test.eldowallet.fr/transits/$TRANSIT_ID/passes/trip/MLH-GVA-20261112-0930' \
   -H 'Accept: application/json' \
   -H 'Content-Type: application/json' \
   -H 'x-lang: fr' \
   -H 'Authorization: Bearer <token>' \
   -d '{
     "departureTime": "09:00",
     "arrivalTime": "11:45"
   }'

   POST/transits/{transitId}/passes/trip/{tripNumber}/notifyEssayer →

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

   • CURL

   curl -L 'https://api-v2.test.eldowallet.fr/transits/$TRANSIT_ID/passes/trip/MLH-GVA-20261112-0930/notify' \
   -H 'Accept: application/json' \
   -H 'Content-Type: application/json' \
   -H 'x-lang: fr' \
   -H 'Authorization: Bearer <token>' \
   -d '{
     "message": "Votre départ est avancé à 09:00."
   }'

   PATCH/transits/{transitId}/passes/trip/{tripNumber}POST/transits/{transitId}/passes/trip/{tripNumber}/notify
6. Corriger un billet individuelVotre serveur

   Changement de date pour un seul voyageur, nouveau siège, faute dans le nom : mettez à jour son billet sans toucher aux autres. Plusieurs corrections d'un coup : utilisez la mise à jour en lot.

   PUT/transits/{transitId}/passes/{passId}PATCH/transits/{transitId}/passes/bulk
7. Valider à l'embarquementVotre serveur

   Le contrôleur scanne le code-barres. Votre terminal retrouve le billet, puis le valide. Un second scan est refusé. Activez l'usage unique sur le modèle pour bloquer un second passage.

   GET/transits/{transitId}/passes/barcode/{barcode}POST/passes/template/{templateId}/redeem/{barcode}PUT/transits/{transitId}/passes/{barcode}/status
8. Suivre les émissionsVotre serveur

   Listez les billets émis par liaison (pagination page et limit) et suivez les statistiques par liaison, type et période.

   GET/transits/{transitId}/passesGET/transits/stats
9. Fidéliser les réguliersVotre serveur

   Ajoutez une carte voyageur : un compteur de trajets sur la carte de fidélité, et un coupon « trajet offert » au 5ᵉ voyage.

   PATCH/clients/{id}/gainPOST/coupons/{id}/passes/send

Bonnes pratiques

• Le tripNumber est indispensable dans les faits. Sans lui, vous devrez mettre à jour chaque billet un par un lors d'un retard.
• Renseignez une date d'expiration. Le billet passe en expiré après le trajet et reste consultable dans l'historique du Wallet comme justificatif.
• Séparez donnée et message. Mettez à jour l'horaire avec un appel, expliquez la raison avec un autre. Le voyageur comprend ce qui change et pourquoi.
• Dates au format YYYY-MM-DD, heures au format HH:mm. Si vous changez la date de départ d'un trajet, envoyez aussi la date d'arrivée.
• Protégez contre le partage. Les options de sécurité du modèle (usage unique, partage iOS désactivé, code-barres rotatif) limitent la revente et les captures d'écran.

Pour aller plus loin

• Mettre à jour un trajet
• Ferry & maritime, même mécanique avec cabines et quais
• Compagnies aériennes, même mécanique avec le type Air
• Codes-barres
• Cycle de vie d'un pass
• Endpoints : POST/transits POST/transits/{transitId}/passes PATCH/transits/{transitId}/passes/trip/{tripNumber} POST/transits/{transitId}/passes/trip/{tripNumber}/notify

Pour vous inspirer

Le billet n’est que le début du voyage. Voici des idées pour accompagner vos voyageurs et les faire revenir.

🧳Le rappel de la veilleLa veille du départ : heure, gare, bagages autorisés et temps de trajet conseillé. Le voyageur part serein.

🅿️Parking relais inclusLe billet s’accompagne d’un ticket de parking relais à la gare de départ. Le voyageur se gare et embarque sans passer au guichet.

🆕Nouvelle ligne, premiers voyageursVous ouvrez une ligne ? Les voyageurs réguliers de la zone sont prévenus en premier, avec un code de lancement.

😴Voyageur en pauseAucun trajet depuis 90 jours : une offre ciblée arrive dans le Wallet pour donner envie de repartir.

💺Plus de confort, en un gesteLa veille du départ, proposez un siège avec plus d’espace, un bagage supplémentaire ou le Wi-Fi à bord. Un complément de revenu sans effort.

🔁Abonnement qui se renouvelleUne semaine avant la fin de l’abonnement mensuel ou de la carte jeune, un rappel avec le lien de renouvellement.

📍Bons plans à destinationÀ l’arrivée, une offre d’un partenaire local : musée, restaurant, location de vélos. Le voyage continue avec vous.

🌱Le CO₂ économiséAu verso du billet, le CO₂ évité par rapport à la voiture, et le cumul de l’année pour les réguliers. Un argument fort et zéro papier.

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