Templates et passes
Deux objets structurent toute l’API eldo wallet :
- Le template : le modèle. Il porte l’identité visuelle et les informations communes à tous les porteurs. Vous le créez une fois.
- Le pass : la carte d’un client précis. Il porte ses données personnelles : nom, place, code-barres, solde. Vous en émettez un par client.
Exemple
Un concert, c’est un template d’événement : nom, lieu, date, strip officiel, couleurs. Chaque spectateur reçoit son pass : porte, rang, siège, code-barres.
Qui porte quoi
| Information | Template | Pass |
|---|---|---|
| Couleurs, strip | ✅ | |
| Format de code-barres | ✅ | |
| Options de sécurité (partage, usage unique…) | ✅ | |
| Conditions, contact | ✅ | |
| Nom et email du porteur | ✅ | |
| Valeur du code-barres | ✅ | |
| Place, trajet, dates, solde propres au client | ✅ |
Les templates par type de pass
| Type | Créer le template | Émettre un pass | Émettre en masse |
|---|---|---|---|
| Coupon | POST/coupons | POST/coupons/{id}/passes/send | (même endpoint, asynchrone) |
| Événement | POST/events | POST/events/{id}/passes | POST/events/{id}/passes/bulk |
| Transport | POST/transits | POST/transits/{transitId}/passes | POST/transits/{transitId}/passes/bulk |
| Hôtel | POST/hotels | POST/hotels/{id}/passes | POST/hotels/{id}/passes/bulk |
Les créations de templates acceptent une image (le strip). Elles s’envoient en multipart/form-data. Les objets imbriqués (colors, security, locations…) passent en chaîne JSON dans le champ du formulaire, les booléens en "true" / "false". Les émissions de passes sont en application/json. Voir Erreurs API fréquentes.
Et la carte de fidélité ?
La carte de fidélité est un cas à part : une seule par wallet. Son template, c’est la store card.
- Vous réglez son design avec PATCH
/store-cards:cardType(STORE_CARDouMEMBER_CARD), nom du programme, couleurs, strip, unité de gain, champs affichés. - Chaque client créé avec POST
/clientsreçoit sa carte (avecsendCard, eldo wallet lui envoie le lien). - Les types de clients rangent les porteurs de la carte par segment.
Modifier un template après coup
Un template modifié se répercute sur les passes déjà émis : un nouveau strip, et toutes les cartes changent de visuel. Faites-le pour une vraie opération, pas tous les jours.