Guides de l’API Apple Wallet et Google Wallet
L'API eldo wallet crée des passes Apple Wallet et Google Wallet et les tient à jour. Le cas le plus courant : votre carte de fidélité, conçue une fois puis envoyée à chacun de vos clients, avec ses points à jour. La même logique sert aux coupons, billets d'événement, titres de transport et réservations d'hôtel : vous concevez un modèle (template) une fois, puis vous émettez un pass par client.
Démarrage rapideVotre première carte de fidélité en 10 minutes.
Référence APIChaque endpoint, ses paramètres, ses réponses et ses erreurs.
Cas d'usageParcours complets par métier, étape par étape.
Base de connaissancesConcepts, FAQ et dépannage.
L'essentiel en un coup d'œil
| URL de base | https://api-v2.test.eldowallet.fr (test, par défaut) — environnements |
| Authentification | Authorization: Bearer <jeton> — détails |
| Format | JSON ; multipart/form-data pour les endpoints qui reçoivent des images — détails |
| Langue des réponses | x-lang: fr ou en — détails |
| Erreurs | Enveloppe unique {message, errorCode, path, date} — liste des codes |
| Pagination | ?page=1&limit=10 — détails |
| Limite de débit | 1 000 requêtes par minute |
| Spécification OpenAPI | openapi.fr.yaml · openapi.en.yaml |
Les objets de l'API
- Wallet : votre espace eldo wallet. Il porte votre marque, vos réglages d'envoi et vos jetons d'accès.
- Modèle : le design et les règles d'un type de pass (couleurs, image, code-barres, sécurité). Exemple : la carte de fidélité « Café Lumière », ou un modèle de billet « Traversée Marseille – Ajaccio ».
- Pass : l'exemplaire émis pour une personne, avec ses données (nom, siège, date…). Il s'installe dans le téléphone et se met à jour à distance.
- Client : un porteur de la carte de fidélité du wallet.
API v1
L'API v1 (api.eldowallet.fr/api/v1) ne sera plus supportée après le 31 décembre 2026. Voir le guide de migration.