Migration depuis l'API v1

Fin du support de l'API v1 : 31 décembre 2026

L'API v1 (https://api.eldowallet.fr/api/v1) ne sera plus supportée après le 31 décembre 2026. Les nouvelles fonctionnalités ne sont disponibles qu'en v2.

Notre équipe support vous accompagne dans la migration : contactez-nous pour planifier votre passage en v2.

Qui est concerné ?

Toute intégration qui appelle une URL commençant par https://api.eldowallet.fr/api/v1/. Si vous utilisez uniquement le back-office eldo wallet, vous n'avez rien à faire.

Ce qui change

	v1	v2
URL de base	https://api.eldowallet.fr/api/v1	https://api-v2.eldowallet.fr (production) ; pour tester : https://api-v2.test.eldowallet.fr — environnements
Identifiant du wallet	dans l'URL (/wallets/{wallet}/transits)	déduit du jeton (/transits)
Connexion	POST /users/login	POST/auth/login
Jetons serveur	—	jetons de wallet révocables
Format d'erreur	{statusCode, status, messageCode, message}	{message, errorCode, path, date} — détails
Pagination	variable selon l'endpoint	uniforme ?page=&limit= — détails
Envois en masse	—	jusqu'à 5 000 éléments, suivi d'avancement — détails
Webhooks	URL simple	événements typés, nouvelles tentatives — détails

Correspondance des principaux endpoints

Besoin	v1	v2
Créer un modèle de transport	POST /wallets/{wallet}/transits	POST/transits
Envoyer un billet de transport	POST /wallets/{wallet}/transits/{transit}/send	POST/transits/{transitId}/passes
Mettre à jour un trajet	PATCH /wallets/{wallet}/transits/{transit}/trip/{tripNumber}	PATCH/transits/{transitId}/passes/trip/{tripNumber}
Notifier un trajet	POST /wallets/{wallet}/transits/{transit}/trip/{tripNumber}	POST/transits/{transitId}/passes/trip/{tripNumber}/notify
Créer un coupon	POST /wallets/{wallet}/coupons	POST/coupons
Envoyer un coupon	POST /wallets/{wallet}/coupons/{coupon}/send	POST/coupons/{id}/passes/send
Créer un événement	POST /wallets/{wallet}/events	POST/events
Créer un client	POST /customers	POST/clients
Valider un pass	PUT /wallets/{wallet}/redeem	POST/passes/template/{templateId}/redeem/{barcode}
Créer un pass d'hôtel	POST /wallets/{wallet}/hotels	POST/hotels

En v2, les cartes d'embarquement s'émettent comme des titres de transport (type: "Air", voir Compagnies aériennes) et les billets de cinéma comme des événements (voir Cinéma).

Étapes de migration

1. Créer un jeton de wallet v2Votre serveur

   Connectez-vous à la v2 et créez un jeton de wallet dédié à votre intégration.

   POST/auth/loginPOST/wallets/tokens
2. Récupérer vos modèles en v2Votre serveur

   Listez vos modèles en v2 pour récupérer leurs identifiants, et créez ceux dont votre intégration a besoin.

   GET/transitsGET/couponsGET/events
3. Adapter vos appelsVotre serveur

   Changez l'URL de base, retirez l'identifiant du wallet des chemins, et adaptez les corps de requête en suivant la référence API.

4. Adapter la gestion des erreursVotre serveur

   Testez errorCode (ex. 400:VALIDATION_ERROR) au lieu de statusCode / messageCode.

5. Basculer et surveillerVotre serveur

   Basculez progressivement, surveillez les erreurs, puis coupez les appels v1 avant le 31 décembre 2026.

La documentation v1 historique reste consultable sur api.eldowallet.fr/api-docs jusqu'à la fin du support.