Créer une carte de fidélité Apple Wallet et Google Wallet en 10 minutes
La carte de fidélité est le pass le plus utilisé d'eldo wallet. En trois appels, vous allez la concevoir, créer un client et lui envoyer sa carte par e-mail. Comptez 10 minutes.
Prérequis : un compte eldo wallet sur l'environnement de test (https://api-v2.test.eldowallet.fr), utilisé par tous les exemples ci-dessous.
Chaque exemple existe en cURL, Node.js, PHP, Python, Java, C#, Go, Ruby et avec le SDK Node.js : choisissez votre langage une fois, il est retenu sur tout le site. Le bouton Essayer ouvre la page de l'endpoint, où vous pouvez l'appeler avec votre jeton.
0. (Facultatif) Installer le SDK Node.js
Vous codez en Node.js ? Générez un client typé, avec autocomplétion sur chaque endpoint et chaque champ, puis utilisez l'onglet SDK Node.js des exemples ci-dessous.
npx api install https://developers.eldowallet.fr/openapi.en.yaml --identifier eldowalletLes noms de méthodes sont les identifiants d'opération de la référence API. Autres langages : SDK et outils.
1. Obtenir un jeton
- curl
- SDK Node.js
- nodejs
- php
- python
- java
- csharp
- go
- ruby
- CURL
curl -L 'https://api-v2.test.eldowallet.fr/auth/login' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-lang: fr' \
-H 'Authorization: Bearer <token>' \
-d '{
"username": "votre-identifiant",
"password": "votre-mot-de-passe"
}'
Réponse :
{"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."}
Gardez ce jeton : il remplace <token> dans les exemples suivants.
export ELDO_TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
Un jeton de connexion est lié à un utilisateur. Pour une intégration serveur, créez un jeton de wallet dédié.
2. Concevoir votre carte de fidélité
La carte de fidélité est unique par wallet : vous réglez son design une fois, et chaque client reçoit son propre exemplaire. Choisissez le type (STORE_CARD pour une carte de magasin avec cagnotte, MEMBER_CARD pour une carte de membre), le nom du programme, les couleurs, l'unité des gains et les champs affichés.
Cet endpoint reçoit une image (strip, le bandeau de la carte) : le corps est en multipart/form-data, et les objets (colors, descriptions) s'envoient en chaîne JSON.
- curl
- SDK Node.js
- nodejs
- php
- python
- java
- csharp
- go
- ruby
- CURL
curl -L -X PATCH 'https://api-v2.test.eldowallet.fr/store-cards' \
-H 'Accept: application/json' \
-H 'x-lang: fr' \
-H 'Authorization: Bearer <token>' \
-F 'strip=@"bandeau-cafe-lumiere.png"' \
-F 'cardType="STORE_CARD"' \
-F 'programName="Café Lumière"' \
-F 'barcodeType="QR_CODE"' \
-F 'gainLabel="POINTS"' \
-F 'gainUnit="POINTS"' \
-F 'startRow="GAIN"' \
-F 'endRow="CREATION_DATE"' \
-F 'descriptions="[{\"title\":\"Programme\",\"value\":\"1 € dépensé = 10 points\"}]"' \
-F 'colors="{\"backgroundColor\":\"\#59358b\",\"labelColor\":\"\#9ee00d\",\"foregroundColor\":\"\#ffffff\"}"'
Le logo, l'icône et les coordonnées affichés sur la carte se règlent sur le wallet (PATCH/wallets). Conseils de design : bonnes pratiques.
3. Créer un client et lui envoyer sa carte
Cette fois, le corps est en JSON. eldo wallet génère la carte du client ; avec sendCard: true, il lui envoie le lien d'installation par e-mail.
- curl
- SDK Node.js
- nodejs
- php
- python
- java
- csharp
- go
- ruby
- CURL
curl -L 'https://api-v2.test.eldowallet.fr/clients' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-lang: fr' \
-H 'Authorization: Bearer <token>' \
--data-raw '{
"firstName": "Camille",
"lastName": "Martin",
"email": "camille.martin@example.com",
"source": "CRM",
"sendCard": true
}'
La réponse contient le client (_id, barcode) et le lien d'installation de sa carte (shortLink), à diffuser aussi dans vos propres canaux. Camille ouvre le lien, et la carte s'ajoute à Apple Wallet ou Google Wallet.
export CLIENT_ID="6650f1c2a9e4b5d1c3a7e921"
4. (Facultatif) Mettre à jour ses points
Après un achat, envoyez le nouveau solde de points du client : la valeur remplace le solde précédent (ce n'est pas un ajout), et chaque valeur est conservée dans l'historique. La carte se met à jour sur son téléphone.
- curl
- SDK Node.js
- nodejs
- php
- python
- java
- csharp
- go
- ruby
- CURL
curl -L -X PATCH 'https://api-v2.test.eldowallet.fr/clients/$CLIENT_ID/gain' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-lang: fr' \
-H 'Authorization: Bearer <token>' \
-d '{
"gain": 1250
}'
Depuis une caisse qui scanne la carte, utilisez plutôt le code-barres : PATCH/clients/barcode/{barcode}/gain.
Et ensuite ?
- Le parcours complet (coupons, paliers, magasins) : cas d'usage Commerce.
- Segmentez vos membres (Silver, Gold) : types de clients.
- Importez votre base existante : import CSV ou opérations en masse.
- Faites remonter la carte près de vos magasins : localisations.
- Soyez prévenu quand une carte est installée : webhooks.
- Prêt pour la mise en ligne : environnements.