Migrating from API v1

End of support for API v1: December 31, 2026

API v1 (https://api.eldowallet.fr/api/v1) will no longer be supported after December 31, 2026. New features are only available in v2.

Our support team will help you migrate: contact us to plan your move to v2.

Who is affected?

Any integration that calls a URL starting with https://api.eldowallet.fr/api/v1/. If you only use the eldo wallet back office, you have nothing to do.

What changes

	v1	v2
Base URL	https://api.eldowallet.fr/api/v1	https://api-v2.eldowallet.fr (production); to try it: https://api-v2.test.eldowallet.fr — environments
Wallet ID	in the URL (/wallets/{wallet}/transits)	derived from the token (/transits)
Login	POST /users/login	POST/auth/login
Server tokens	—	revocable wallet tokens
Error format	{statusCode, status, messageCode, message}	{message, errorCode, path, date} — details
Pagination	varies by endpoint	uniform ?page=&limit= — details
Bulk sending	—	up to 5,000 items, with progress tracking — details
Webhooks	plain URL	typed events, retries — details

Main endpoint mapping

Need	v1	v2
Create a transit template	POST /wallets/{wallet}/transits	POST/transits
Send a transit ticket	POST /wallets/{wallet}/transits/{transit}/send	POST/transits/{transitId}/passes
Update a trip	PATCH /wallets/{wallet}/transits/{transit}/trip/{tripNumber}	PATCH/transits/{transitId}/passes/trip/{tripNumber}
Notify a trip	POST /wallets/{wallet}/transits/{transit}/trip/{tripNumber}	POST/transits/{transitId}/passes/trip/{tripNumber}/notify
Create a coupon	POST /wallets/{wallet}/coupons	POST/coupons
Send a coupon	POST /wallets/{wallet}/coupons/{coupon}/send	POST/coupons/{id}/passes/send
Create an event	POST /wallets/{wallet}/events	POST/events
Create a customer	POST /customers	POST/clients
Redeem a pass	PUT /wallets/{wallet}/redeem	POST/passes/template/{templateId}/redeem/{barcode}
Create a hotel pass	POST /wallets/{wallet}/hotels	POST/hotels

In v2, boarding passes are issued as transit passes (type: "Air", see Airlines) and movie tickets as events (see Cinema).

Migration steps

1. Create a v2 wallet tokenYour server

   Log in to v2 and create a wallet token dedicated to your integration.

   POST/auth/loginPOST/wallets/tokens
2. Retrieve your templates in v2Your server

   List your templates in v2 to get their IDs, and create the ones your integration needs.

   GET/transitsGET/couponsGET/events
3. Update your callsYour server

   Change the base URL, remove the wallet ID from paths, and adapt request bodies following the API reference.

4. Update your error handlingYour server

   Test errorCode (e.g. 400:VALIDATION_ERROR) instead of statusCode / messageCode.

5. Switch over and monitorYour server

   Switch over gradually, monitor errors, then turn off v1 calls before December 31, 2026.

The legacy v1 documentation remains available at api.eldowallet.fr/api-docs until the end of support.