Billets de ferry dans Apple Wallet et Google Wallet

Une traversée se prépare la veille et se vit dans les 30 minutes avant l'embarquement. eldo wallet entre dans ces deux moments. Le billet est dans Apple Wallet ou Google Wallet dès la réservation, le rappel arrive au bon moment, le changement de quai aussi. Le passager attend chez lui en cas de retard, pas sur le quai.

📲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 traverséeBack-office

   Utilisez le type Boat. Renseignez les ports et leurs codes, l'horaire de référence, le tarif, les conditions de transport et le numéro du service client. Choisissez seatName=N_CABINE pour afficher le champ siège comme numéro de cabine. Un modèle par liaison suffit.

   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=@"traversee.png"' \
   -F 'type="Boat"' \
   -F 'number="1"' \
   -F 'originStationCode="MRS"' \
   -F 'originName="Marseille"' \
   -F 'destinationStationCode="AJA"' \
   -F 'destinationName="Ajaccio"' \
   -F 'departureTime="17:30"' \
   -F 'arrivalTime="05:30"' \
   -F 'seatName="N_CABINE"' \
   -F 'details="Embarquement 45 minutes avant le départ."' \
   -F 'terms="Billet nominatif. Pièce d'\''identité obligatoire."' \
   -F 'barcodeFormat="QR_CODE"' \
   -F 'colors="{\"backgroundColor\":\"\#0b5a7a\",\"labelColor\":\"\#c8f15f\",\"foregroundColor\":\"\#ffffff\"}"'

   POST/transits
2. Émettre le billet à la réservationVotre serveur

   Votre système de réservation appelle eldo wallet pour chaque billet, avec le tripNumber de la rotation et la cabine dans seat. Ajoutez la liste des passagers et le véhicule embarqué dans les champs personnalisés du verso (customBackFields). Pour un groupe, émettez en lot.

   POST/transits/{transitId}/passesPOST/transits/{transitId}/passes/bulk
3. Le passager ajoute son billetClient final

   Il l'ouvre depuis l'email de confirmation. Plus de PDF à imprimer.

4. Rappel d'embarquementVotre serveur

   30 minutes avant le départ, votre système d'horaires envoie un message à tous les porteurs de la rotation : « Embarquement dans 30 min, quai B6. Pensez à votre pièce d'identité. »

   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/MRS-AJA-20260718/notify' \
   -H 'Accept: application/json' \
   -H 'Content-Type: application/json' \
   -H 'x-lang: fr' \
   -H 'Authorization: Bearer <token>' \
   -d '{
     "message": "Embarquement dans 30 min, quai B6. Pensez à votre pièce d’identité."
   }'

   POST/transits/{transitId}/passes/trip/{tripNumber}/notify
5. Changement de quai ou retardVotre serveur

   Mauvais temps, retard d'une heure : mettez à jour l'horaire de tous les billets du trajet, puis expliquez la raison par un message. Le quai change ? Un message suffit.

   PATCH/transits/{transitId}/passes/trip/{tripNumber}POST/transits/{transitId}/passes/trip/{tripNumber}/notify
6. Modifier un passagerVotre serveur

   Changement de cabine, ajout d'un enfant, report sur une autre rotation : mettez à jour le billet concerné, y compris son tripNumber.

   PUT/transits/{transitId}/passes/{passId}
7. EmbarquerVotre serveur

   Le personnel scanne le code-barres. Le billet est retrouvé, puis validé.

   GET/transits/{transitId}/passes/barcode/{barcode}POST/passes/template/{templateId}/redeem/{barcode}
8. Carte voyageur et surclassementsVotre serveur

   Comptez les traversées sur la carte de fidélité (« 8/10 traversées »). Au palier, envoyez un coupon de surclassement cabine. Avant l'été, relancez les passagers de l'an dernier avec un coupon ciblé.

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

Bonnes pratiques

• Un tripNumber par rotation, pas par liaison. Le 17:30 du lundi et celui du mardi sont deux trajets distincts.
• Une famille, combien de billets ? Un billet par réservation avec la liste des passagers au verso suffit pour l'embarquement groupé. Un billet par passager devient nécessaire si chacun est contrôlé séparément.
• Prévenez tôt. Un retard annoncé à la maison évite une foule sur le quai. Déclenchez la mise à jour dès que votre système de pilotage le détecte.
• Renseignez la date d'expiration. Le billet passe en expiré après la traversée.

Pour aller plus loin

• Transport & mobilité, le même modèle pour bus et trains
• Mettre à jour un trajet
• Notifications push
• Endpoints : POST/transits POST/transits/{transitId}/passes PATCH/transits/{transitId}/passes/trip/{tripNumber} POST/transits/{transitId}/passes/trip/{tripNumber}/notify

Pour vous inspirer

Une traversée, c’est aussi des vacances qui commencent. Voici des idées pour enrichir l’expérience de vos passagers.

📋La check-list de la veilleLa veille du départ : heure limite d’arrivée au port, papiers d’identité, animaux, hauteur du véhicule. Moins de questions au guichet.

🍽️Restaurant et boutique à bordDès l’embarquement, une offre pour le restaurant, le bar ou la boutique du bord arrive sur le billet. Le voyage devient un moment.

⚡Places de dernière minuteUne traversée encore peu remplie ? Proposez un tarif de dernière minute aux passagers réguliers de la liaison.

🏝️Bons plans à l’arrivéeÀ l’approche du port d’arrivée, une offre d’un partenaire local : location de voiture, excursion, restaurant.

🎂Anniversaire du voyageurLe jour de son anniversaire, le voyageur fidèle reçoit une réduction sur sa prochaine traversée.

⏳L’avoir qui expireUn passager a un avoir après une annulation ? Un rappel avant son expiration l’invite à réserver.

⭐Avis après la traverséeLe lendemain de l’arrivée, un message demande au passager de noter sa traversée, avec un lien direct.

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