# eldo wallet Developers

> eldo wallet API v2: create, send and update Apple Wallet and Google Wallet passes (loyalty cards, coupons, event, transit and hotel passes).

## Guides

- [Guides de l’API Apple Wallet et Google Wallet](https://developers.eldowallet.fr/docs/): Intégrez l'API eldo wallet pour créer et mettre à jour des passes Apple Wallet et Google Wallet : cartes de fidélité, coupons, billets, titres de transport.
- [Authentification](https://developers.eldowallet.fr/docs/authentication): Jetons de connexion, jetons de wallet, en-têtes acceptés et expiration.
- [Opérations en masse](https://developers.eldowallet.fr/docs/bulk-operations): Créer, modifier ou supprimer jusqu'à 5 000 passes en un appel, et suivre l'avancement.
- [Changelog](https://developers.eldowallet.fr/docs/changelog): Évolutions de l'API eldo wallet et de sa documentation.
- [Environnements](https://developers.eldowallet.fr/docs/environments): Test par défaut pour développer, production pour la mise en ligne : URL de base, jetons et bonnes pratiques.
- [Erreurs](https://developers.eldowallet.fr/docs/errors): Format unique des erreurs de l'API eldo wallet et liste complète des codes.
- [Images et multipart](https://developers.eldowallet.fr/docs/files-and-images): Envoyer des images et des objets imbriqués avec multipart/form-data.
- [Langue des réponses](https://developers.eldowallet.fr/docs/localization): Choisir la langue des messages et des erreurs de l'API.
- [Migration depuis l'API v1](https://developers.eldowallet.fr/docs/migration-v1): L'API v1 ne sera plus supportée après le 31 décembre 2026. Ce qui change et comment migrer.
- [Pagination](https://developers.eldowallet.fr/docs/pagination): Parcourir les listes de l'API avec page et limit.
- [Créer une carte de fidélité Apple Wallet et Google Wallet en 10 minutes](https://developers.eldowallet.fr/docs/quickstart): Démarrage rapide de l'API : authentifiez-vous, concevez votre carte de fidélité, créez un client et envoyez sa carte Apple Wallet ou Google Wallet.
- [SDK et outils](https://developers.eldowallet.fr/docs/sdks): Générer un client typé depuis la spécification OpenAPI, Postman, et outils pour assistants IA.
- [Webhooks](https://developers.eldowallet.fr/docs/webhooks): Recevoir en temps réel les créations de clients et les installations de passes.

## Use cases

- [Cas d'usage Apple Wallet et Google Wallet par secteur](https://developers.eldowallet.fr/use-cases/): Cartes de fidélité, coupons, billets, titres de transport et badges dans Apple Wallet et Google Wallet : parcours d'intégration par API pour 13 secteurs.
- [Cartes d'embarquement Apple Wallet et Google Wallet](https://developers.eldowallet.fr/use-cases/airlines): Cartes d'embarquement dans Apple Wallet et Google Wallet avec vol, porte et siège, mises à jour par API en cas de retard ou de changement de porte.
- [Carte d'adhérent d'association dans Apple Wallet et Google Wallet](https://developers.eldowallet.fr/use-cases/associations): Carte d'adhérent digitale dans Apple Wallet et Google Wallet pour les associations : catégories de membres, renouvellement annuel, billets et messages.
- [Carte de fidélité garage dans Apple Wallet et Google Wallet](https://developers.eldowallet.fr/use-cases/automotive): Carte client garage et programme de points pour les professionnels dans Apple Wallet et Google Wallet, avec rappels d'entretien et offres saisonnières.
- [Billets de cinéma dans Apple Wallet et Google Wallet](https://developers.eldowallet.fr/use-cases/cinema): Billets de séance dans Apple Wallet et Google Wallet, envoyés après l'achat avec salle, rang et place, validés à l'entrée, puis coupons de fidélité.
- [Billets d'événement dans Apple Wallet et Google Wallet](https://developers.eldowallet.fr/use-cases/events): Billets de concert, de salon et de conférence dans Apple Wallet et Google Wallet : placement, contrôle à l’entrée et mise à jour de tous les billets en un appel.
- [Billets de ferry dans Apple Wallet et Google Wallet](https://developers.eldowallet.fr/use-cases/ferry): Billets de traversée, cabines et embarquement sans papier dans Apple Wallet et Google Wallet, avec notifications de quai et de retard envoyées par API.
- [Carte de membre de salle de sport dans Apple Wallet et Google Wallet](https://developers.eldowallet.fr/use-cases/fitness-clubs): Carte de membre digitale dans Apple Wallet et Google Wallet pour salles de sport : scan à l'entrée, formules, rappels de cours, renouvellement, parrainage.
- [Carte d'adhérent mutuelle dans Apple Wallet et Google Wallet](https://developers.eldowallet.fr/use-cases/health-insurance): Carte d'adhérent mutuelle dématérialisée dans Apple Wallet et Google Wallet, toujours à jour, avec garanties, rappels de renouvellement et documents.
- [Réservations d'hôtel dans Apple Wallet et Google Wallet](https://developers.eldowallet.fr/use-cases/hotels): Confirmation de réservation dans Apple Wallet et Google Wallet : numéro de chambre au check-in et offres pendant le séjour, pour hôtels et résidences.
- [Badge salarié dans Apple Wallet et Google Wallet](https://developers.eldowallet.fr/use-cases/hr-employees): Badge salarié dans Apple Wallet et Google Wallet, badges visiteurs pour vos séminaires, communication interne, avantages salariés et départs en un appel.
- [Carte de fidélité Apple Wallet et Google Wallet pour le retail](https://developers.eldowallet.fr/use-cases/retail): Carte de fidélité dématérialisée dans Apple Wallet et Google Wallet pour le retail et la mode : cagnotte en temps réel, coupons et notifications par API.
- [Carte d'abonné et billets de match dans Apple Wallet et Google Wallet](https://developers.eldowallet.fr/use-cases/sport): Carte d'abonné, billets de match et offres boutique dans Apple Wallet et Google Wallet pour les clubs sportifs : accès au stade et notifications par API.
- [Titres de transport dans Apple Wallet et Google Wallet](https://developers.eldowallet.fr/use-cases/transport): Billets de bus, car, train et tram dans Apple Wallet et Google Wallet, disponibles hors ligne et mis à jour en temps réel en cas de retard, par API.

## Knowledge base

- [Base de connaissances Apple Wallet et Google Wallet](https://developers.eldowallet.fr/kb/): Concepts, guides pratiques, FAQ et dépannage pour créer, envoyer et mettre à jour des cartes et passes Apple Wallet et Google Wallet avec eldo wallet.
- [Apple Wallet vs Google Wallet : les différences](https://developers.eldowallet.fr/kb/concepts/apple-vs-google-wallet): Apple Wallet ou Google Wallet : les différences de design, de mise à jour, de notifications et de partage qui comptent quand vous émettez des passes.
- [Codes-barres des passes Wallet : QR, Aztec, PDF417](https://developers.eldowallet.fr/kb/concepts/barcodes): Choisir le format de code-barres d’un pass Apple Wallet ou Google Wallet (QR, Aztec, PDF417, Code 128), gérer sa valeur et les options anti-fraude.
- [Types de clients](https://developers.eldowallet.fr/kb/concepts/customer-types): Segmenter les porteurs de votre carte de fidélité en types (VIP, pro, standard…) et définir le type par défaut.
- [Design d’un pass Apple Wallet et Google Wallet](https://developers.eldowallet.fr/kb/concepts/design-guidelines): Couleurs, logo, icône, strip et contrastes : les règles pour concevoir une carte ou un pass lisible et conforme sur Apple Wallet et Google Wallet.
- [Localisations et notifications de proximité](https://developers.eldowallet.fr/kb/concepts/locations): Associer des points GPS à vos passes Apple Wallet et Google Wallet pour qu’ils apparaissent sur l’écran de verrouillage quand le client est à proximité.
- [Cycle de vie d’un pass Wallet](https://developers.eldowallet.fr/kb/concepts/pass-lifecycle): Les états d’un pass Apple Wallet ou Google Wallet, de l’envoi à l’expiration, et les appels API qui le font changer d’état : redeem, unredeem, statut.
- [Types de passes Apple Wallet et Google Wallet](https://developers.eldowallet.fr/kb/concepts/pass-types): Carte de fidélité, coupon, billet, titre de transport, réservation d’hôtel : les types de passes Apple Wallet et Google Wallet et le cas d’usage de chacun.
- [Templates et passes](https://developers.eldowallet.fr/kb/concepts/templates-vs-passes): La différence entre un template (le modèle, créé une fois) et un pass (l’instance envoyée à un client).
- [FAQ Apple Wallet et Google Wallet](https://developers.eldowallet.fr/kb/faq/general): Questions fréquentes sur les cartes et passes Apple Wallet et Google Wallet : installation, mise à jour, partage, changement de téléphone, intégration API.
- [Importer une base clients](https://developers.eldowallet.fr/kb/guides/import-customers-csv): Migrer une base CRM ou un fichier CSV vers eldo wallet en une opération, avec ou sans envoi immédiat des cartes.
- [Envoyer à des non-clients](https://developers.eldowallet.fr/kb/guides/send-to-non-clients): Distribuer un coupon ou un billet à des personnes qui n’ont pas encore de carte de fidélité, sans créer leur fiche au préalable.
- [Retard, annulation : mettre à jour un trajet](https://developers.eldowallet.fr/kb/guides/update-a-trip): Retard, changement d’horaire ou de station, annulation : mettre à jour tous les billets d’un trajet en un seul appel et prévenir les voyageurs.
- [Notifications push Apple Wallet et Google Wallet](https://developers.eldowallet.fr/kb/push-notifications): Envoyer une notification sur l’écran de verrouillage des porteurs de vos cartes Apple Wallet et Google Wallet, à tous ou à une sélection, tout de suite ou planifiée.
- [Erreurs API fréquentes](https://developers.eldowallet.fr/kb/troubleshooting/common-api-errors): Les erreurs que l’on rencontre le plus souvent en intégrant l’API eldo wallet, leur cause et la correction.
- [Email ou SMS non reçu](https://developers.eldowallet.fr/kb/troubleshooting/email-not-received): Le client n’a jamais reçu l’email ou le SMS avec son lien d’ajout au Wallet. Causes fréquentes et solutions.
- [Le pass ne se met pas à jour](https://developers.eldowallet.fr/kb/troubleshooting/pass-not-updating): Vous avez modifié un client, un gain ou un trajet, mais le pass du client affiche toujours l’ancienne valeur. Les vérifications à faire, dans l’ordre.

## API reference

- [Référence de l'API Apple Wallet et Google Wallet](https://developers.eldowallet.fr/api/): Référence complète de l'API REST eldo wallet v2 pour Apple Wallet et Google Wallet : endpoints, paramètres, réponses, erreurs et exemples en huit langages.
- [Activer ou désactiver une communication](https://developers.eldowallet.fr/api/reference/actif-or-inactif-communication): Active (`ACTIF`) ou désactive (`INACTIF`) une communication sans modifier son contenu. L'activation la met en ligne sur la carte de fidélité ; la désactivation d'une communication en ligne rétablit le visuel d'origine de la carte.
- [Authentification](https://developers.eldowallet.fr/api/reference/auth): Authentification
- [Se connecter et obtenir un jeton](https://developers.eldowallet.fr/api/reference/auth-login-user): Échange un identifiant (`username`) et un mot de passe contre un jeton d'accès JWT, renvoyé dans `token`. Envoyez ensuite ce jeton dans l'en-tête `Authorization: Bearer <jeton>` de chaque requête.
- [Modifier le mot de passe](https://developers.eldowallet.fr/api/reference/auth-update-password): Modifie le mot de passe du compte connecté, après vérification du mot de passe actuel (`currentPassword`). Ne renvoie aucun contenu en cas de succès.
- [Créer des passes d'événement en masse](https://developers.eldowallet.fr/api/reference/bulk-create-event-passes): Traitement asynchrone. La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Créer des passes d'hôtel en masse](https://developers.eldowallet.fr/api/reference/bulk-create-hotel-passes): Traitement asynchrone. La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Créer des passes de transport en masse](https://developers.eldowallet.fr/api/reference/bulk-create-transit-passes): Traitement asynchrone. La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Supprimer des coupons en masse](https://developers.eldowallet.fr/api/reference/bulk-delete-coupon-passes): La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Supprimer des passes d'événement en masse](https://developers.eldowallet.fr/api/reference/bulk-delete-event-passes): La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Supprimer des passes d'hôtel en masse](https://developers.eldowallet.fr/api/reference/bulk-delete-hotel-passes): La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Supprimer des passes de transport en masse](https://developers.eldowallet.fr/api/reference/bulk-delete-transit-passes): La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Opérations en masse](https://developers.eldowallet.fr/api/reference/bulk-operations): Opérations en masse
- [Obtenir le statut d'une opération en masse](https://developers.eldowallet.fr/api/reference/bulk-operations-get-operation-status): Renvoie l'état d'avancement et les résultats d'une opération en masse lancée par votre wallet (envoi, mise à jour ou suppression en masse). Interrogez cette route avec l'`operationId` renvoyé au lancement jusqu'à ce que `status` vaille `completed` ou `failed`.
- [Mettre à jour des coupons en masse](https://developers.eldowallet.fr/api/reference/bulk-update-coupon-passes): La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Mettre à jour des passes d'événement en masse](https://developers.eldowallet.fr/api/reference/bulk-update-event-passes): La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Mettre à jour des passes d'hôtel en masse](https://developers.eldowallet.fr/api/reference/bulk-update-hotel-passes): La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Mettre à jour des passes de transport en masse](https://developers.eldowallet.fr/api/reference/bulk-update-transit-passes): La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Types de clients](https://developers.eldowallet.fr/api/reference/client-types): Types de clients
- [Créer un type de client](https://developers.eldowallet.fr/api/reference/client-types-create): Crée un type de client (par exemple VIP ou standard) sur la carte de fidélité du wallet. Le nom du type apparaît sur la carte des clients qui y sont rattachés. Renvoie le type créé.
- [Lister les types de clients](https://developers.eldowallet.fr/api/reference/client-types-find-all): Liste paginée des types de clients (segments) rattachés à la carte de fidélité du wallet. Chaque type indique s'il est le type par défaut (`isDefault`), attribué aux clients créés sans `clientType`.
- [Obtenir un type de client](https://developers.eldowallet.fr/api/reference/client-types-find-one): Renvoie un type de client à partir de son identifiant : nom, statut de type par défaut (`isDefault`) et carte de fidélité associée.
- [Supprimer un type de client](https://developers.eldowallet.fr/api/reference/client-types-remove): Supprime un type de client et renvoie le type supprimé.
- [Mettre à jour un type de client](https://developers.eldowallet.fr/api/reference/client-types-update): Renomme un type de client ou change le type par défaut du wallet. Renvoie le type mis à jour.
- [Clients](https://developers.eldowallet.fr/api/reference/clients): Clients
- [Créer des clients en masse](https://developers.eldowallet.fr/api/reference/clients-bulk-create): La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Mettre à jour des clients en masse](https://developers.eldowallet.fr/api/reference/clients-bulk-update): La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Créer un client](https://developers.eldowallet.fr/api/reference/clients-create): Crée un client et sa carte de fidélité à partir du modèle de carte du wallet. Sans `clientType`, le client reçoit le type par défaut ; sans `barcode`, son identifiant sert de code-barres (si la carte en affiche un). Renvoie le client avec les informations de sa carte (`passId`, `passStatus`, `shortLink`).
- [Supprimer un client](https://developers.eldowallet.fr/api/reference/clients-delete): Supprime un client et sa carte de fidélité. Renvoie les données du client supprimé.
- [Supprimer des clients en masse](https://developers.eldowallet.fr/api/reference/clients-delete-bulk): La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Supprimer un client par code-barres](https://developers.eldowallet.fr/api/reference/clients-delete-by-barcode): Supprime un client identifié par le code-barres de sa carte de fidélité, ainsi que sa carte. Renvoie les données du client supprimé.
- [Obtenir les statistiques des clients](https://developers.eldowallet.fr/api/reference/clients-get-stats): Renvoie les statistiques des clients du wallet : répartition par source (`crmSource`, `internalSource`, `extrnalSource`), cartes actives et inactives, et cartes actives ou supprimées par plateforme (iOS, Android). Limitez la période avec `startDate` et `endDate` (date de création).
- [Relancer les clients aux passes inactifs](https://developers.eldowallet.fr/api/reference/clients-reminder-inactive-passes): Envoie un rappel par e-mail et/ou SMS aux clients dont la carte de fidélité est au statut `inactive`. `type: all` cible tous ces clients, `type: specific` uniquement les clients listés dans `ids`. Renvoie le nombre de cartes trouvées (`totalPasses`), de rappels mis en file (`emailsQueued`) et de cartes ignorées (`passesSkipped`).
- [Synchroniser les passes de tous les clients](https://developers.eldowallet.fr/api/reference/clients-sync-all): Régénère la carte de fidélité de tous les clients du wallet à partir de leurs données enregistrées, pour réaligner les cartes installées. Indiquez `clientType` pour ne traiter que les clients d'un type. Le traitement est asynchrone : la réponse donne uniquement le nombre de clients à synchroniser (`clientsToSync`).
- [Mettre à jour un client](https://developers.eldowallet.fr/api/reference/clients-update): Met à jour un client et sa carte de fidélité. Seuls les champs envoyés sont modifiés ; la carte installée sur le téléphone du client est mise à jour en conséquence. Renvoie le client mis à jour.
- [Mettre à jour un client par code-barres](https://developers.eldowallet.fr/api/reference/clients-update-by-barcode): Met à jour un client identifié par le code-barres de sa carte de fidélité. Même comportement que `PATCH /clients/{id}` : seuls les champs envoyés sont modifiés et la carte est mise à jour. Renvoie le client mis à jour.
- [Mettre à jour les points (gains) d'un client](https://developers.eldowallet.fr/api/reference/clients-update-pass-gain): Remplace le solde de points (`gain`) d'un client et met à jour sa carte de fidélité. Renvoie le client mis à jour.
- [Mettre à jour les points (gains) d'un client par code-barres](https://developers.eldowallet.fr/api/reference/clients-update-pass-gain-by-barcode): Remplace le solde de points (`gain`) d'un client identifié par le code-barres de sa carte de fidélité. Même comportement que `PATCH /clients/{id}/gain`. Renvoie le client mis à jour.
- [Consentements](https://developers.eldowallet.fr/api/reference/communication-preferences): Consentements
- [Obtenir l'historique des préférences de communication d'un client](https://developers.eldowallet.fr/api/reference/communication-preferences-get-history): Renvoie l'historique paginé des changements de préférences de communication d'un client, du plus récent au plus ancien. Chaque entrée indique le canal et l'événement concernés, l'ancienne et la nouvelle valeur, l'auteur du changement et sa date, avec des libellés traduits.
- [Obtenir les préférences de communication d'un client](https://developers.eldowallet.fr/api/reference/communication-preferences-get-preferences): Renvoie les préférences de communication d'un client : canaux autorisés (`email`, `sms`, `notification`) par type de notification, consentement aux notifications push informatives et commerciales, et lien vers la page publique où le client gère lui-même ses préférences (`consentLink`).
- [Mettre à jour les préférences de communication d'un client](https://developers.eldowallet.fr/api/reference/communication-preferences-update-preferences): Met à jour les préférences de communication d'un client, au nom d'un gestionnaire. Seuls les types de notification et les canaux envoyés sont modifiés. Renvoie les préférences à jour.
- [Communications](https://developers.eldowallet.fr/api/reference/communications): Communications
- [Supprimer un coupon](https://developers.eldowallet.fr/api/reference/coupon-passes-delete-pass): Supprime définitivement un coupon envoyé. Sur un modèle multi-instance, cet appel supprime tout le modèle et tous ses coupons (voir ci-dessous).
- [Faire expirer un coupon](https://developers.eldowallet.fr/api/reference/coupon-passes-expire-pass): Fait expirer immédiatement un coupon envoyé : son statut passe à `expired` et sa date d'expiration devient la date du jour. Renvoie le coupon mis à jour, ou `PASS_ALREADY_EXPIRED` s'il est déjà expiré.
- [Lister les coupons d'un client](https://developers.eldowallet.fr/api/reference/coupon-passes-get-client-passes): Recherche des coupons envoyés à partir de la valeur passée dans `clientId` : coupons dont le code-barres est égal à cette valeur, ou dont le prénom, le nom ou l'e-mail la contient. Seuls les coupons au statut `active` ou `expired` sont renvoyés.
- [Obtenir un coupon](https://developers.eldowallet.fr/api/reference/coupon-passes-get-instance-passes): Renvoie un coupon envoyé, identifié par son modèle et son `instanceId`. Renvoie `PASS_NOT_FOUND` si aucun coupon de ce modèle ne correspond.
- [Lister les coupons d'un modèle](https://developers.eldowallet.fr/api/reference/coupon-passes-get-passes): Renvoie la liste paginée des coupons envoyés à partir d'un modèle. Par défaut, seuls les coupons au statut `active` ou `expired` sont renvoyés, du plus récent au plus ancien.
- [Envoyer des coupons](https://developers.eldowallet.fr/api/reference/coupon-passes-send-coupons): Envoie un coupon à des clients existants ou à des destinataires qui ne sont pas clients. Avec `clientId`, les données de la carte de fidélité du client sont utilisées ; sans `clientId`, `firstName`, `lastName` et `email` sont obligatoires. Accepte `multipart/form-data` pour remplacer l'image du bandeau. `webhookUrl` et `forceSync` sont facultatifs. La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
- [Mettre à jour un coupon](https://developers.eldowallet.fr/api/reference/coupon-passes-update-pass): Met à jour les valeurs propres à un coupon envoyé : `promoCode`, `description`, `value`, `expirationDate` et `bannerOverrideUrl`. Seuls les champs fournis sont modifiés ; les autres valeurs restent celles du coupon ou, à défaut, du modèle. Renvoie le coupon mis à jour.
- [Modifier le statut d'un coupon](https://developers.eldowallet.fr/api/reference/coupon-passes-update-pass-status): Statuts possibles : `EXPIRED`, `USED`, `UNUSED`.
- [Coupons](https://developers.eldowallet.fr/api/reference/coupons): Coupons
- [Créer une communication](https://developers.eldowallet.fr/api/reference/create-communication): Crée une communication (offre) affichée sur la carte de fidélité de tous les porteurs du wallet : un visuel `strip` remplace la bannière de la carte et la `description` s'ajoute au verso. Elle est publiée tout de suite avec `instant: true`, sinon à `startDate`, et dure jusqu'à `endDate` ou sans fin avec `unlimited: true`. Renvoie la communication créée.
- [Créer un modèle de coupon](https://developers.eldowallet.fr/api/reference/create-coupon-template): Crée un modèle de coupon dans votre wallet et le modèle de pass associé. La requête est envoyée en `multipart/form-data` avec l'image du bandeau (`strip`). Le modèle créé est renvoyé ; utilisez ensuite `POST /coupons/{id}/passes/send` pour envoyer des coupons à vos clients.
- [Créer un événement](https://developers.eldowallet.fr/api/reference/create-event): Crée un événement, c'est-à-dire le modèle de billet (nom, dates, lieux, couleurs, bannière) utilisé par tous ses passes. La requête est envoyée en `multipart/form-data` et renvoie l'événement créé.
- [Créer un hôtel](https://developers.eldowallet.fr/api/reference/create-hotel): Crée un hôtel, c'est-à-dire le modèle de pass (titre, couleurs, avantages, format de code-barres, adresse, bannière) utilisé par toutes ses réservations. La requête est envoyée en `multipart/form-data` et renvoie l'hôtel créé.
- [Créer un modèle de transport](https://developers.eldowallet.fr/api/reference/create-transit): Crée un modèle de transport (bus, train, bateau, avion, tram ou générique) et son modèle de pass Apple Wallet et Google Wallet. Envoyez la requête en `multipart/form-data` avec l'image `strip` (obligatoire) ; le `number` du modèle sert de numéro de trajet par défaut des passes.
- [Créer un jeton de wallet](https://developers.eldowallet.fr/api/reference/create-wallet-token): Crée un jeton d'accès pour le wallet, à utiliser à la place d'un JWT pour les intégrations serveur à serveur. Le jeton est renvoyé dans le champ `token` ; `expiresAt` est facultatif.
- [Import / export CSV](https://developers.eldowallet.fr/api/reference/csv-operations): Import / export CSV
- [Exporter les clients en CSV](https://developers.eldowallet.fr/api/reference/csv-operations-export-csv-clients): Export en arrière-plan : la réponse est une opération CSV dont vous suivez l'avancement avec `GET /csv-operations`.
- [Importer des clients depuis un CSV](https://developers.eldowallet.fr/api/reference/csv-operations-upload-csv-clients): Import en arrière-plan : la réponse est une opération CSV dont vous suivez l'avancement avec `GET /csv-operations`.
- [Supprimer une communication](https://developers.eldowallet.fr/api/reference/delete-communication): Supprime définitivement une communication. Si elle était en ligne (`ACTIVE`), la carte de fidélité retrouve son visuel d'origine et les porteurs sont notifiés de la fin de l'offre. Renvoie la communication supprimée.
- [Supprimer un modèle de coupon](https://developers.eldowallet.fr/api/reference/delete-coupon-template): Supprime définitivement un modèle de coupon et son modèle de pass. Renvoie le modèle supprimé.
- [Supprimer un événement](https://developers.eldowallet.fr/api/reference/delete-event): Supprime un événement et son modèle de billet. Renvoie l'événement supprimé.
- [Supprimer un hôtel](https://developers.eldowallet.fr/api/reference/delete-hotel): Supprime un hôtel et son modèle de pass. Renvoie l'hôtel supprimé.
- [Supprimer un modèle de transport](https://developers.eldowallet.fr/api/reference/delete-transit): Supprime un modèle de transport et son modèle de pass. La suppression est refusée (`400 HOTEL_HAS_PASSES`) tant que des passes existent pour ce modèle.
- [Supprimer un jeton de wallet](https://developers.eldowallet.fr/api/reference/delete-wallet-token): Supprime (révoque) un jeton d'accès du wallet. Ne renvoie aucun contenu en cas de succès.
- [eldo wallet API](https://developers.eldowallet.fr/api/reference/eldo-wallet-api): L'API eldo wallet permet de créer des modèles de passes Apple Wallet et Google Wallet
- [Créer un pass d'événement](https://developers.eldowallet.fr/api/reference/event-passes-create-non-client-pass): Crée un billet pour un événement, soit pour un client existant (`clientId`), soit pour un porteur qui n'est pas client (`firstName`, `lastName`, `email`). Renvoie le pass créé, avec son lien court d'installation.
- [Obtenir un pass d'événement](https://developers.eldowallet.fr/api/reference/event-passes-find-by-id): Renvoie un pass d'événement à partir de son identifiant.
- [Lister les passes d'un événement](https://developers.eldowallet.fr/api/reference/event-passes-get-all-pass-by-event): Renvoie la liste paginée des passes émis pour un événement, avec filtres par statut et date de création, et recherche texte.
- [Obtenir un pass d'événement par code-barres](https://developers.eldowallet.fr/api/reference/event-passes-get-pass-by-barcode): Renvoie un pass d'événement à partir de la valeur de son code-barres, par exemple après un scan au contrôle d'accès.
- [Mettre à jour un pass d'événement](https://developers.eldowallet.fr/api/reference/event-passes-update): Met à jour un pass d'événement (porteur, code-barres, rangées) et pousse la modification sur le pass installé. Les champs omis gardent leur valeur actuelle.
- [Modifier le statut d'un pass d'événement par code-barres](https://developers.eldowallet.fr/api/reference/event-passes-update-pass-status-by-barcode): Marque un billet comme utilisé (`USED`) ou non utilisé (`UNUSED`) à partir de son code-barres. À utiliser au contrôle d'accès pour valider une entrée, ou pour annuler une validation.
- [Événements](https://developers.eldowallet.fr/api/reference/events): Événements
- [Obtenir un client](https://developers.eldowallet.fr/api/reference/get-client-details): Renvoie un client à partir de son identifiant, avec l'état de sa carte de fidélité (`passStatus`, `deviceTypes`, `shortLink`), le nom de son type (`clientTypeName`) et le statut de ses autres passes.
- [Obtenir un client par code-barres](https://developers.eldowallet.fr/api/reference/get-client-details-by-barcode): Renvoie un client du wallet à partir du code-barres de sa carte de fidélité, avec l'état de sa carte. Pratique en caisse, après le scan de la carte.
- [Lister les clients](https://developers.eldowallet.fr/api/reference/get-clients): Liste paginée des clients du wallet avec l'état de leur carte de fidélité (`passStatus`, `deviceTypes`, `shortLink`). Combinez la recherche plein texte (`search`), les filtres exacts et le filtre de statut pour retrouver un client ou un segment.
- [Obtenir une communication](https://developers.eldowallet.fr/api/reference/get-communication): Renvoie une communication par son identifiant, avec son statut, ses dates et la clé de son visuel `strip`.
- [Obtenir les statistiques d'envoi d'une communication](https://developers.eldowallet.fr/api/reference/get-communication-delivery-stats): Statistiques de remise de la notification push d'une communication, par porteur de carte de fidélité active (avec son e-mail et son téléphone), paginées, avec un résumé du taux de réussite global et par plateforme (iOS, Android). Le résumé indique aussi le statut de la communication et sa prochaine échéance (début ou fin).
- [Lister les communications](https://developers.eldowallet.fr/api/reference/get-communications): Liste paginée des communications du wallet, filtrables par statut, par plage de dates de début et par recherche texte sur la description.
- [Obtenir les statistiques des coupons d'un modèle](https://developers.eldowallet.fr/api/reference/get-coupon-pass-stats): Renvoie deux compteurs pour un modèle de coupon : le nombre de coupons envoyés (`countOfSentCouponPasses`) et le nombre de coupons ajoutés à un wallet mobile (`countOfDownloadedPasses`).
- [Obtenir un modèle de coupon](https://developers.eldowallet.fr/api/reference/get-coupon-template): Renvoie un modèle de coupon à partir de son identifiant. Renvoie `MODEL_NOT_FOUND` si le modèle n'existe pas.
- [Lister les modèles de coupon](https://developers.eldowallet.fr/api/reference/get-coupon-templates): Renvoie la liste paginée des modèles de coupon de votre wallet. Vous pouvez filtrer par statut, nom, code promo, type de modèle (instance unique ou multi-instance) et date de création, ou faire une recherche libre.
- [Lister les opérations CSV](https://developers.eldowallet.fr/api/reference/get-csv-operations): Liste les opérations d'import et d'export CSV du wallet, les plus récentes en premier par défaut. Utilisez-la pour suivre l'avancement d'un import ou d'un export lancé en arrière-plan et récupérer le fichier produit (`fileLink`). Filtrez par `operationType` (`IMPORT` ou `EXPORT`).
- [Obtenir un événement](https://developers.eldowallet.fr/api/reference/get-event): Renvoie le détail d'un événement de votre wallet à partir de son identifiant.
- [Lister les événements](https://developers.eldowallet.fr/api/reference/get-events): Renvoie la liste paginée des événements de votre wallet. Chaque événement est un modèle de billet à partir duquel vous émettez des passes.
- [Obtenir un hôtel](https://developers.eldowallet.fr/api/reference/get-hotel): Renvoie le détail d'un hôtel de votre wallet à partir de son identifiant.
- [Lister les hôtels](https://developers.eldowallet.fr/api/reference/get-hotels): Renvoie la liste paginée des hôtels de votre wallet. Chaque hôtel est un modèle de pass à partir duquel vous émettez des réservations.
- [Obtenir le wallet](https://developers.eldowallet.fr/api/reference/get-my-wallet): Renvoie le wallet associé au jeton utilisé : nom, coordonnées, réseaux sociaux, logos, fuseau horaire, types de passes autorisés et conditions générales. Utilisez-le pour vérifier votre jeton et la configuration du wallet.
- [Obtenir un modèle de transport](https://developers.eldowallet.fr/api/reference/get-transit): Renvoie un modèle de transport du wallet à partir de son identifiant.
- [Lister les modèles de transport](https://developers.eldowallet.fr/api/reference/get-transits): Liste, page par page, les modèles de transport du wallet pour un type donné (`type` obligatoire : `Bus`, `Boat`, `Train`, `Air`, `Generic` ou `Tram`).
- [Créer un pass d'hôtel](https://developers.eldowallet.fr/api/reference/hotel-passes-create): Crée un pass de réservation pour un hôtel : porteur, dates d'arrivée (`checkin`) et de départ (`checkout`), chambre et avantages. Renvoie le pass créé.
- [Supprimer un pass d'hôtel](https://developers.eldowallet.fr/api/reference/hotel-passes-delete): Supprime définitivement un pass de réservation. Renvoie le pass supprimé.
- [Obtenir un pass d'hôtel](https://developers.eldowallet.fr/api/reference/hotel-passes-find-by-id): Renvoie un pass de réservation à partir de son identifiant.
- [Lister les passes d'un hôtel](https://developers.eldowallet.fr/api/reference/hotel-passes-get-all-pass-by-hotel): Renvoie la liste paginée des passes de réservation émis pour un hôtel, avec filtres par statut et date de création, et recherche texte.
- [Mettre à jour un pass d'hôtel](https://developers.eldowallet.fr/api/reference/hotel-passes-update): Met à jour une réservation (dates, chambre, porteur, statut) et pousse la modification sur le pass installé. Passez `status` à `canceled` pour annuler la réservation.
- [Hôtels](https://developers.eldowallet.fr/api/reference/hotels): Hôtels
- [Lister les jetons du wallet](https://developers.eldowallet.fr/api/reference/list-wallet-tokens): Liste, page par page, les jetons d'accès créés pour le wallet, avec leur date d'expiration éventuelle.
- [Modèles de notification](https://developers.eldowallet.fr/api/reference/notification-templates): Modèles de notification
- [Créer un modèle de notification](https://developers.eldowallet.fr/api/reference/notification-templates-create): Crée le modèle de notification d'un type (`notificationType`) pour le wallet. L'objet, le corps de l'e-mail et le texte de la notification push omis reprennent le contenu par défaut du type. Un seul modèle par type et par wallet : utilisez la mise à jour pour modifier un modèle existant.
- [Lister les modèles de notification](https://developers.eldowallet.fr/api/reference/notification-templates-find-by-wallet): Liste tous les modèles de notification du wallet (au plus un par type de notification), avec l'objet et le corps HTML de l'e-mail, le texte du SMS et le texte de la notification push.
- [Obtenir le modèle de notification d'un type](https://developers.eldowallet.fr/api/reference/notification-templates-find-by-wallet-and-notification-type): Renvoie le modèle de notification d'un type pour le wallet et le crée avec le contenu par défaut s'il n'existe pas encore. Le type doit correspondre à un type de pass activé sur le wallet.
- [Obtenir un modèle de notification](https://developers.eldowallet.fr/api/reference/notification-templates-find-one): Renvoie un modèle de notification par son identifiant.
- [Supprimer un modèle de notification](https://developers.eldowallet.fr/api/reference/notification-templates-remove): Supprime un modèle de notification. Il est recréé avec le contenu par défaut au prochain accès par type.
- [Mettre à jour un modèle de notification](https://developers.eldowallet.fr/api/reference/notification-templates-update): Met à jour un modèle de notification : objet et corps de l'e-mail, texte du SMS ou texte de la notification push. Seuls les champs envoyés sont modifiés. Renvoie le modèle mis à jour.
- [Validation](https://developers.eldowallet.fr/api/reference/passes): Validation
- [Notifications push](https://developers.eldowallet.fr/api/reference/push-notifications): Notifications push
- [Créer une notification push](https://developers.eldowallet.fr/api/reference/push-notifications-create): Crée une notification push envoyée sur les cartes de fidélité installées, à tous les porteurs (`target: ALL`) ou à une liste de clients (`target: SPECIFIC`), immédiatement (`INSTANT`) ou à `scheduleAt` (`SCHEDULED`). Les destinataires sont résolus à la création et enregistrés dans `clients`. Renvoie la notification créée.
- [Lister les notifications push](https://developers.eldowallet.fr/api/reference/push-notifications-find-all): Liste paginée des notifications push du wallet, immédiates ou programmées, avec leurs destinataires et leur date d'envoi (`sentAt`).
- [Obtenir une notification push](https://developers.eldowallet.fr/api/reference/push-notifications-find-one): Renvoie une notification push par son identifiant, avec ses destinataires, son type, sa catégorie et ses dates de programmation et d'envoi.
- [Obtenir les statistiques d'une notification push](https://developers.eldowallet.fr/api/reference/push-notifications-get-stats): Statistiques de remise d'une notification push, par destinataire (appareils atteints, plateformes, statut final `DELIVERED`, `FAILED` ou `PENDING`), paginées, avec un résumé du taux de réussite global et par plateforme (iOS, Android).
- [Supprimer une notification push](https://developers.eldowallet.fr/api/reference/push-notifications-remove): Supprime une notification push. Une notification programmée supprimée avant son heure d'envoi n'est pas envoyée. Renvoie `{'deleted': true}`.
- [Mettre à jour une notification push](https://developers.eldowallet.fr/api/reference/push-notifications-update): Remplace le contenu, la cible, la catégorie ou la programmation d'une notification push et recalcule ses destinataires. Utile pour modifier une notification programmée avant son envoi. Renvoie la notification mise à jour.
- [Valider un pass](https://developers.eldowallet.fr/api/reference/redeem-pass): Marque le pass comme utilisé. Renvoie `PASS_ALREADY_REDEEMED` si le pass a déjà été validé.
- [ActifOrInactifCommunicationDto](https://developers.eldowallet.fr/api/reference/schemas/actiforinactifcommunicationdto)
- [AdditionalContact](https://developers.eldowallet.fr/api/reference/schemas/additionalcontact)
- [AdditionalContactDto](https://developers.eldowallet.fr/api/reference/schemas/additionalcontactdto)
- [AdditionalInformationItemDto](https://developers.eldowallet.fr/api/reference/schemas/additionalinformationitemdto)
- [BulkCreateClientsDto](https://developers.eldowallet.fr/api/reference/schemas/bulkcreateclientsdto)
- [BulkCreateEventPassesDto](https://developers.eldowallet.fr/api/reference/schemas/bulkcreateeventpassesdto)
- [BulkCreateHotelPassesDto](https://developers.eldowallet.fr/api/reference/schemas/bulkcreatehotelpassesdto)
- [BulkCreateTransitPassesDto](https://developers.eldowallet.fr/api/reference/schemas/bulkcreatetransitpassesdto)
- [BulkDeleteClientsDto](https://developers.eldowallet.fr/api/reference/schemas/bulkdeleteclientsdto)
- [BulkDeleteCouponPassesDto](https://developers.eldowallet.fr/api/reference/schemas/bulkdeletecouponpassesdto)
- [BulkDeleteEventPassesDto](https://developers.eldowallet.fr/api/reference/schemas/bulkdeleteeventpassesdto)
- [BulkDeleteHotelPassesDto](https://developers.eldowallet.fr/api/reference/schemas/bulkdeletehotelpassesdto)
- [BulkDeleteTransitPassesDto](https://developers.eldowallet.fr/api/reference/schemas/bulkdeletetransitpassesdto)
- [BulkOperationErrorDto](https://developers.eldowallet.fr/api/reference/schemas/bulkoperationerrordto)
- [BulkOperationItemResultDto](https://developers.eldowallet.fr/api/reference/schemas/bulkoperationitemresultdto)
- [BulkOperationResponseDto](https://developers.eldowallet.fr/api/reference/schemas/bulkoperationresponsedto)
- [BulkOperationStatus](https://developers.eldowallet.fr/api/reference/schemas/bulkoperationstatus): Current status of the operation
- [BulkUpdateClientItemDto](https://developers.eldowallet.fr/api/reference/schemas/bulkupdateclientitemdto)
- [BulkUpdateClientsDto](https://developers.eldowallet.fr/api/reference/schemas/bulkupdateclientsdto)
- [BulkUpdateCouponPassesDto](https://developers.eldowallet.fr/api/reference/schemas/bulkupdatecouponpassesdto)
- [BulkUpdateCouponPassItemDto](https://developers.eldowallet.fr/api/reference/schemas/bulkupdatecouponpassitemdto)
- [BulkUpdateEventPassesDto](https://developers.eldowallet.fr/api/reference/schemas/bulkupdateeventpassesdto)
- [BulkUpdateEventPassItemDto](https://developers.eldowallet.fr/api/reference/schemas/bulkupdateeventpassitemdto)
- [BulkUpdateHotelPassesDto](https://developers.eldowallet.fr/api/reference/schemas/bulkupdatehotelpassesdto)
- [BulkUpdateHotelPassItemDto](https://developers.eldowallet.fr/api/reference/schemas/bulkupdatehotelpassitemdto)
- [BulkUpdateTransitPassesDto](https://developers.eldowallet.fr/api/reference/schemas/bulkupdatetransitpassesdto)
- [BulkUpdateTransitPassItemDto](https://developers.eldowallet.fr/api/reference/schemas/bulkupdatetransitpassitemdto)
- [Client](https://developers.eldowallet.fr/api/reference/schemas/client)
- [ClientType](https://developers.eldowallet.fr/api/reference/schemas/clienttype)
- [ClientWithBarcodeDto](https://developers.eldowallet.fr/api/reference/schemas/clientwithbarcodedto)
- [ClientWithPassInfoResponseDto](https://developers.eldowallet.fr/api/reference/schemas/clientwithpassinforesponsedto)
- [Color](https://developers.eldowallet.fr/api/reference/schemas/color)
- [ColorCreateDto](https://developers.eldowallet.fr/api/reference/schemas/colorcreatedto)
- [ColorDto](https://developers.eldowallet.fr/api/reference/schemas/colordto)
- [Communication](https://developers.eldowallet.fr/api/reference/schemas/communication)
- [CommunicationCreateDto](https://developers.eldowallet.fr/api/reference/schemas/communicationcreatedto)
- [CommunicationDeliveryStatsSummaryDto](https://developers.eldowallet.fr/api/reference/schemas/communicationdeliverystatssummarydto)
- [CommunicationPreferenceLog](https://developers.eldowallet.fr/api/reference/schemas/communicationpreferencelog)
- [CommunicationPreferencesResponseDto](https://developers.eldowallet.fr/api/reference/schemas/communicationpreferencesresponsedto)
- [CommunicationRecipientDeliveryDto](https://developers.eldowallet.fr/api/reference/schemas/communicationrecipientdeliverydto)
- [CommunicationRule](https://developers.eldowallet.fr/api/reference/schemas/communicationrule)
- [CommunicationRuleDto](https://developers.eldowallet.fr/api/reference/schemas/communicationruledto)
- [CommunicationRuleInputDto](https://developers.eldowallet.fr/api/reference/schemas/communicationruleinputdto)
- [CommunicationUpdateDto](https://developers.eldowallet.fr/api/reference/schemas/communicationupdatedto)
- [Coupon](https://developers.eldowallet.fr/api/reference/schemas/coupon)
- [CouponIosHeader](https://developers.eldowallet.fr/api/reference/schemas/couponiosheader)
- [CouponIosHeaderDto](https://developers.eldowallet.fr/api/reference/schemas/couponiosheaderdto)
- [CouponPassStatsDto](https://developers.eldowallet.fr/api/reference/schemas/couponpassstatsdto)
- [CouponSecurity](https://developers.eldowallet.fr/api/reference/schemas/couponsecurity)
- [CouponSecurityDto](https://developers.eldowallet.fr/api/reference/schemas/couponsecuritydto)
- [CreateClientDto](https://developers.eldowallet.fr/api/reference/schemas/createclientdto)
- [CreateClientTypeDto](https://developers.eldowallet.fr/api/reference/schemas/createclienttypedto)
- [CreateCouponDto](https://developers.eldowallet.fr/api/reference/schemas/createcoupondto)
- [CreateEventDto](https://developers.eldowallet.fr/api/reference/schemas/createeventdto)
- [CreateEventPassDto](https://developers.eldowallet.fr/api/reference/schemas/createeventpassdto)
- [CreateHotelDto](https://developers.eldowallet.fr/api/reference/schemas/createhoteldto)
- [CreateHotelPassDto](https://developers.eldowallet.fr/api/reference/schemas/createhotelpassdto)
- [CreateNotificationTemplateDto](https://developers.eldowallet.fr/api/reference/schemas/createnotificationtemplatedto)
- [CreateOpaqueTokenDto](https://developers.eldowallet.fr/api/reference/schemas/createopaquetokendto)
- [CreatePushNotificationDto](https://developers.eldowallet.fr/api/reference/schemas/createpushnotificationdto)
- [CreateTransitDto](https://developers.eldowallet.fr/api/reference/schemas/createtransitdto)
- [CreateTransitPassDto](https://developers.eldowallet.fr/api/reference/schemas/createtransitpassdto)
- [CreateTransitPassResponseDto](https://developers.eldowallet.fr/api/reference/schemas/createtransitpassresponsedto)
- [CsvOperation](https://developers.eldowallet.fr/api/reference/schemas/csvoperation)
- [CustomBackFieldDto](https://developers.eldowallet.fr/api/reference/schemas/custombackfielddto)
- [Description](https://developers.eldowallet.fr/api/reference/schemas/description)
- [DescriptionDto](https://developers.eldowallet.fr/api/reference/schemas/descriptiondto)
- [Device](https://developers.eldowallet.fr/api/reference/schemas/device)
- [DisplayOptions](https://developers.eldowallet.fr/api/reference/schemas/displayoptions)
- [DisplayOptionsDto](https://developers.eldowallet.fr/api/reference/schemas/displayoptionsdto)
- [EmailAuth](https://developers.eldowallet.fr/api/reference/schemas/emailauth)
- [EmailAuthDto](https://developers.eldowallet.fr/api/reference/schemas/emailauthdto)
- [EmailConfig](https://developers.eldowallet.fr/api/reference/schemas/emailconfig)
- [EmailConfigDto](https://developers.eldowallet.fr/api/reference/schemas/emailconfigdto)
- [ErrorResponse](https://developers.eldowallet.fr/api/reference/schemas/errorresponse)
- [Event](https://developers.eldowallet.fr/api/reference/schemas/event)
- [EventDate](https://developers.eldowallet.fr/api/reference/schemas/eventdate)
- [EventDateDto](https://developers.eldowallet.fr/api/reference/schemas/eventdatedto)
- [EventLocation](https://developers.eldowallet.fr/api/reference/schemas/eventlocation)
- [EventLocationDto](https://developers.eldowallet.fr/api/reference/schemas/eventlocationdto)
- [EventStatus](https://developers.eldowallet.fr/api/reference/schemas/eventstatus)
- [GainHistory](https://developers.eldowallet.fr/api/reference/schemas/gainhistory)
- [Hotel](https://developers.eldowallet.fr/api/reference/schemas/hotel)
- [InstanceLinks](https://developers.eldowallet.fr/api/reference/schemas/instancelinks)
- [IOSHeader](https://developers.eldowallet.fr/api/reference/schemas/iosheader)
- [IOSHeaderDto](https://developers.eldowallet.fr/api/reference/schemas/iosheaderdto)
- [Location](https://developers.eldowallet.fr/api/reference/schemas/location)
- [LocationCreateDto](https://developers.eldowallet.fr/api/reference/schemas/locationcreatedto)
- [LocationHotelCreateDto](https://developers.eldowallet.fr/api/reference/schemas/locationhotelcreatedto)
- [LoginResponseDto](https://developers.eldowallet.fr/api/reference/schemas/loginresponsedto)
- [LoginUserDto](https://developers.eldowallet.fr/api/reference/schemas/loginuserdto)
- [NotificationTemplate](https://developers.eldowallet.fr/api/reference/schemas/notificationtemplate)
- [Object](https://developers.eldowallet.fr/api/reference/schemas/object)
- [ObjectId](https://developers.eldowallet.fr/api/reference/schemas/objectid)
- [OpaqueToken](https://developers.eldowallet.fr/api/reference/schemas/opaquetoken)
- [PaginatedResponseDto](https://developers.eldowallet.fr/api/reference/schemas/paginatedresponsedto)
- [Pass](https://developers.eldowallet.fr/api/reference/schemas/pass)
- [PatchCouponPassOverrideDto](https://developers.eldowallet.fr/api/reference/schemas/patchcouponpassoverridedto)
- [PushNotification](https://developers.eldowallet.fr/api/reference/schemas/pushnotification)
- [PushNotificationClient](https://developers.eldowallet.fr/api/reference/schemas/pushnotificationclient)
- [PushNotificationClientDto](https://developers.eldowallet.fr/api/reference/schemas/pushnotificationclientdto)
- [PushNotificationRecipientStatsDto](https://developers.eldowallet.fr/api/reference/schemas/pushnotificationrecipientstatsdto)
- [PushNotificationStatsSummaryDto](https://developers.eldowallet.fr/api/reference/schemas/pushnotificationstatssummarydto)
- [RelevantText](https://developers.eldowallet.fr/api/reference/schemas/relevanttext)
- [RelevantTextListItemDto](https://developers.eldowallet.fr/api/reference/schemas/relevanttextlistitemdto)
- [ReminderInactivePassesDto](https://developers.eldowallet.fr/api/reference/schemas/reminderinactivepassesdto)
- [ReminderInactivePassesResponseDto](https://developers.eldowallet.fr/api/reference/schemas/reminderinactivepassesresponsedto)
- [SecurityCreateDto](https://developers.eldowallet.fr/api/reference/schemas/securitycreatedto)
- [SecurityDefinition](https://developers.eldowallet.fr/api/reference/schemas/securitydefinition)
- [SendCouponsDto](https://developers.eldowallet.fr/api/reference/schemas/sendcouponsdto)
- [SendTransitNotificationDto](https://developers.eldowallet.fr/api/reference/schemas/sendtransitnotificationdto)
- [SmsConfig](https://developers.eldowallet.fr/api/reference/schemas/smsconfig)
- [SmsConfigDto](https://developers.eldowallet.fr/api/reference/schemas/smsconfigdto)
- [SocialMedia](https://developers.eldowallet.fr/api/reference/schemas/socialmedia)
- [SocialMediaDto](https://developers.eldowallet.fr/api/reference/schemas/socialmediadto)
- [StatsTransitPassResponseDto](https://developers.eldowallet.fr/api/reference/schemas/statstransitpassresponsedto)
- [StoreCard](https://developers.eldowallet.fr/api/reference/schemas/storecard)
- [StoreCardDetailsResponseDto](https://developers.eldowallet.fr/api/reference/schemas/storecarddetailsresponsedto)
- [StoreCardUpdateDto](https://developers.eldowallet.fr/api/reference/schemas/storecardupdatedto)
- [SyncAllClientsDto](https://developers.eldowallet.fr/api/reference/schemas/syncallclientsdto)
- [SyncAllClientsResponseDto](https://developers.eldowallet.fr/api/reference/schemas/syncallclientsresponsedto)
- [TermsAndConditions](https://developers.eldowallet.fr/api/reference/schemas/termsandconditions)
- [TermsAndConditionsDto](https://developers.eldowallet.fr/api/reference/schemas/termsandconditionsdto)
- [Transit](https://developers.eldowallet.fr/api/reference/schemas/transit)
- [TransitIosHeader](https://developers.eldowallet.fr/api/reference/schemas/transitiosheader)
- [TransitIosHeaderDto](https://developers.eldowallet.fr/api/reference/schemas/transitiosheaderdto)
- [UpdateClientDto](https://developers.eldowallet.fr/api/reference/schemas/updateclientdto)
- [UpdateClientTypeDto](https://developers.eldowallet.fr/api/reference/schemas/updateclienttypedto)
- [UpdateCommunicationPreferencesDto](https://developers.eldowallet.fr/api/reference/schemas/updatecommunicationpreferencesdto)
- [UpdateCouponDto](https://developers.eldowallet.fr/api/reference/schemas/updatecoupondto)
- [UpdateCouponPassStatusDto](https://developers.eldowallet.fr/api/reference/schemas/updatecouponpassstatusdto)
- [UpdateEventDto](https://developers.eldowallet.fr/api/reference/schemas/updateeventdto)
- [UpdateEventPassDto](https://developers.eldowallet.fr/api/reference/schemas/updateeventpassdto)
- [UpdateEventPassStatusDto](https://developers.eldowallet.fr/api/reference/schemas/updateeventpassstatusdto)
- [UpdateHotelDto](https://developers.eldowallet.fr/api/reference/schemas/updatehoteldto)
- [UpdateHotelPassDto](https://developers.eldowallet.fr/api/reference/schemas/updatehotelpassdto)
- [UpdateNotificationTemplateDto](https://developers.eldowallet.fr/api/reference/schemas/updatenotificationtemplatedto)
- [UpdatePassGainDto](https://developers.eldowallet.fr/api/reference/schemas/updatepassgaindto)
- [UpdatePasswordDto](https://developers.eldowallet.fr/api/reference/schemas/updatepassworddto)
- [UpdatePushNotificationDto](https://developers.eldowallet.fr/api/reference/schemas/updatepushnotificationdto)
- [UpdateSpecificClientDto](https://developers.eldowallet.fr/api/reference/schemas/updatespecificclientdto)
- [UpdateTransitDto](https://developers.eldowallet.fr/api/reference/schemas/updatetransitdto)
- [UpdateTransitPassDto](https://developers.eldowallet.fr/api/reference/schemas/updatetransitpassdto)
- [UpdateTransitPassStatusDto](https://developers.eldowallet.fr/api/reference/schemas/updatetransitpassstatusdto)
- [UpdateTripDto](https://developers.eldowallet.fr/api/reference/schemas/updatetripdto)
- [UpdateWalletSettingsDto](https://developers.eldowallet.fr/api/reference/schemas/updatewalletsettingsdto)
- [UploadClientsCsvDto](https://developers.eldowallet.fr/api/reference/schemas/uploadclientscsvdto)
- [Validity](https://developers.eldowallet.fr/api/reference/schemas/validity)
- [ValidityDto](https://developers.eldowallet.fr/api/reference/schemas/validitydto)
- [Wallet](https://developers.eldowallet.fr/api/reference/schemas/wallet)
- [WalletCreateDto](https://developers.eldowallet.fr/api/reference/schemas/walletcreatedto)
- [WalletLocation](https://developers.eldowallet.fr/api/reference/schemas/walletlocation)
- [WalletLocationCreateDto](https://developers.eldowallet.fr/api/reference/schemas/walletlocationcreatedto)
- [WalletLocationUpdateDto](https://developers.eldowallet.fr/api/reference/schemas/walletlocationupdatedto)
- [WalletSetting](https://developers.eldowallet.fr/api/reference/schemas/walletsetting)
- [WalletUpdateDto](https://developers.eldowallet.fr/api/reference/schemas/walletupdatedto)
- [Obtenir la carte de fidélité](https://developers.eldowallet.fr/api/reference/store-card-get): Renvoie la carte de fidélité du wallet, c'est-à-dire le modèle commun à toutes les cartes de vos clients : type de carte, design, textes, unité de gain et règles de validité. Chaque wallet a une seule carte de fidélité.
- [Obtenir le détail de la carte de fidélité](https://developers.eldowallet.fr/api/reference/store-card-get-details): Renvoie un résumé de la carte de fidélité utile pour construire un formulaire client : type de carte (`cardType`), types de clients disponibles (`clientTypes`), date d'expiration calculée d'après la validité de la carte (`expirationDate`), contenu des lignes de la carte (`startRow`, `middleRow`, `endRow`) et canal de communication du wallet. `isUnlimited` vaut `true` quand la carte n'expire pas.
- [Mettre à jour la carte de fidélité](https://developers.eldowallet.fr/api/reference/store-card-update): Met à jour le modèle de la carte de fidélité du wallet (design, textes, bandeau, validité, unité de gain…) et applique les changements aux cartes déjà émises. Accepte `application/json` ou `multipart/form-data` (pour envoyer l'image `strip`). Renvoie la carte mise à jour.
- [Carte de fidélité](https://developers.eldowallet.fr/api/reference/store-cards): Carte de fidélité
- [Créer un pass de transport](https://developers.eldowallet.fr/api/reference/transit-passes-create): Crée un titre de transport pour un voyageur à partir d'un modèle de transport et renvoie son identifiant, son code-barres et son lien de téléchargement (`downloadLink`). Avec `enableSendEmailOrSms: true`, le titre est aussi envoyé par e-mail ou SMS (`email` ou `phoneNumber`).
- [Obtenir un pass de transport](https://developers.eldowallet.fr/api/reference/transit-passes-find-by-id): Renvoie un titre de transport à partir de son identifiant.
- [Lister les passes d'un transport](https://developers.eldowallet.fr/api/reference/transit-passes-get-all-pass-by-transit): Liste, page par page, les passes d'un modèle de transport, avec filtres par statut, date de création et recherche. Chaque pass inclut `departureDateTime`, `arrivalDateTime` (format `dd-MM-yyyy HH:mm`) et les types d'appareils sur lesquels il est installé (`devices`).
- [Obtenir un pass de transport par code-barres](https://developers.eldowallet.fr/api/reference/transit-passes-get-pass-by-barcode): Renvoie un titre de transport à partir de son code-barres, par exemple lors d'un contrôle.
- [Obtenir les statistiques des transports](https://developers.eldowallet.fr/api/reference/transit-passes-get-transit-stats): Renvoie les statistiques des titres de transport du wallet : nombre total (`totalCustomers`), actifs (`totalActifCustomers`) et validés (`redeemedPassesCount`). Filtrez par modèle, par type de transport ou par période de création.
- [Notifier les porteurs d'un trajet](https://developers.eldowallet.fr/api/reference/transit-passes-send-notification-by-trip-number): Envoie une notification aux porteurs des passes de ce numéro de trajet.
- [Mettre à jour un pass de transport](https://developers.eldowallet.fr/api/reference/transit-passes-update): Met à jour un titre de transport (voyageur, trajet, horaires, siège, code-barres…) et le pass installé. Le porteur est notifié selon le modèle `UPDATE_TRANSIT` et ses préférences ; une requête sans changement renvoie le pass tel quel.
- [Modifier le statut d'un pass de transport par code-barres](https://developers.eldowallet.fr/api/reference/transit-passes-update-pass-status-by-barcode): Marque un titre de transport comme utilisé (`status: USED`) ou annule cette validation (`status: UNUSED`), à partir de son code-barres. Le pass installé est mis à jour sans notification ; renvoie `PASS_ALREADY_REDEEMED` ou `PASS_NOT_REDEEMED` si le statut ne change pas.
- [Mettre à jour un trajet](https://developers.eldowallet.fr/api/reference/transit-passes-update-trip): Met à jour les passes de transport qui partagent ce numéro de trajet.
- [Transports](https://developers.eldowallet.fr/api/reference/transits): Transports
- [Annuler la validation d'un pass](https://developers.eldowallet.fr/api/reference/unredeem-pass): Annule la validation du pass. Renvoie `PASS_NOT_REDEEMED` si le pass n'a pas été validé.
- [Mettre à jour une communication](https://developers.eldowallet.fr/api/reference/update-communication): Met à jour une communication : texte, visuel, dates ou statut (`EXPIRED` n'est pas accepté). Si la communication est en ligne, la carte est mise à jour et les porteurs sont notifiés. Renvoie la communication mise à jour.
- [Mettre à jour un modèle de coupon](https://developers.eldowallet.fr/api/reference/update-coupon-template): Met à jour un modèle de coupon et le modèle de pass associé ; les coupons déjà envoyés sont mis à jour en conséquence. Accepte `application/json` ou `multipart/form-data` (pour remplacer l'image `strip`). Attention : si vous n'envoyez pas `expirationDate`, la date d'expiration du modèle est effacée.
- [Mettre à jour un événement](https://developers.eldowallet.fr/api/reference/update-event): Met à jour un événement. Seuls les champs envoyés sont modifiés, et le modèle des billets déjà émis est mis à jour en conséquence. Accepte `multipart/form-data` (pour changer la bannière) ou `application/json`.
- [Mettre à jour un hôtel](https://developers.eldowallet.fr/api/reference/update-hotel): Met à jour un hôtel. Seuls les champs envoyés sont modifiés, et le modèle des passes déjà émis est mis à jour en conséquence. Accepte `multipart/form-data` (pour changer la bannière) ou `application/json`.
- [Mettre à jour les champs spécifiques du pass d'un client](https://developers.eldowallet.fr/api/reference/update-specific-client): Champs concernés : `overrideStrip`, `additionalInformations`, `barcode`, `altBarcode`.
- [Mettre à jour un modèle de transport](https://developers.eldowallet.fr/api/reference/update-transit): Met à jour un modèle de transport ; les passes déjà installés sont mis à jour. Les porteurs sont notifiés selon le modèle de notification `UPDATE_TRANSIT`. Accepte `multipart/form-data` (nouvelle image `strip`) ou `application/json`.
- [Localisations](https://developers.eldowallet.fr/api/reference/wallet-locations): Localisations
- [Créer une localisation](https://developers.eldowallet.fr/api/reference/wallet-locations-create): Ajoute une localisation au wallet : `latitude`, `longitude`, et un texte (`relevantText`) ou des textes par créneau horaire (`relevantTextList`). Près de ce lieu, la carte de fidélité peut apparaître sur l'écran verrouillé avec ce texte.
- [Lister les localisations](https://developers.eldowallet.fr/api/reference/wallet-locations-list): Liste, page par page, les localisations du wallet (coordonnées et textes affichés à proximité).
- [Supprimer une localisation](https://developers.eldowallet.fr/api/reference/wallet-locations-remove): Supprime une localisation du wallet. Renvoie `{'success': true}`.
- [Mettre à jour une localisation](https://developers.eldowallet.fr/api/reference/wallet-locations-update): Modifie les coordonnées ou les textes d'une localisation. Renvoie la localisation mise à jour.
- [Paramètres du wallet](https://developers.eldowallet.fr/api/reference/wallet-settings): Paramètres du wallet
- [Obtenir les paramètres du wallet](https://developers.eldowallet.fr/api/reference/wallet-settings-find-by-wallet): Renvoie les paramètres d'envoi du wallet : canal de communication (`communicationChannel`), configuration e-mail et SMS, et règles d'envoi par type de notification (`communicationRules`).
- [Mettre à jour les paramètres du wallet](https://developers.eldowallet.fr/api/reference/wallet-settings-update): Met à jour les paramètres d'envoi du wallet : canal de communication, configuration SMS ou e-mail, et règles d'envoi par type de notification. Seuls les champs envoyés sont modifiés ; renvoie les paramètres mis à jour.
- [Wallet](https://developers.eldowallet.fr/api/reference/wallets): Wallet
- [Créer un wallet](https://developers.eldowallet.fr/api/reference/wallets-create): Crée un nouveau wallet avec ses coordonnées, ses logos et ses conditions générales. Réservé aux comptes administrateurs ; les intégrations utilisent `GET /wallets` et `PATCH /wallets` sur leur propre wallet.
- [Mettre à jour le wallet](https://developers.eldowallet.fr/api/reference/wallets-update): Met à jour le wallet du jeton utilisé : nom, coordonnées, réseaux sociaux, logos, fuseau horaire, webhooks ou conditions générales. Seuls les champs envoyés sont modifiés ; accepte `multipart/form-data` (pour les images) ou `application/json`.
- [Mettre à jour la configuration du générateur de passes](https://developers.eldowallet.fr/api/reference/wallets-update-pass-builder): Resynchronise le wallet avec le générateur de passes : complète sa configuration si nécessaire, puis relance la mise à jour de tous ses passes installés. Sans corps de requête ; renvoie le wallet.
- [Mettre à jour les conditions générales](https://developers.eldowallet.fr/api/reference/wallets-update-terms-and-conditions): Définit les conditions générales du wallet : aucune (`type: NONE`), un lien (`type: URL` avec `customUrl`) ou un fichier PDF de 5 Mo maximum (`type: PDF` avec `pdfFile`, en multipart). Renvoie le wallet mis à jour.

## OpenAPI

- [OpenAPI 3 specification](https://developers.eldowallet.fr/openapi.fr.yaml): complete machine-readable API contract