Carte de fidélité Apple Wallet et Google Wallet pour le retail
Vêtements, chaussures ou cosmétiques : le parcours est toujours le même. Embaser, animer, récompenser. eldo wallet remplace la carte plastique par une carte de fidélité dématérialisée qui vit dans le téléphone, dans Apple Wallet ou Google Wallet. Le client la retrouve sur son écran de verrouillage, voit sa cagnotte monter à chaque passage en caisse et reçoit ses coupons sans ouvrir un email.
Essayez ce pass en directRemplissez le formulaire, voyez le pass et le code se mettre à jour, puis recevez-le sur votre téléphone.Le parcours client
Workflow d'intégration
- Paramétrer la carte de fidélitéBack-office
La carte de fidélité (store card) est unique par wallet. Réglez une fois le type (
STORE_CARDouMEMBER_CARD), le nom du programme, les couleurs, le strip, le libellé et l'unité de gain (POINTS,EURO…) et les trois champs affichés sur la carte. Le logo, l'icône et les contacts se règlent sur le wallet. Faites-le dans le back-office ou par l'API. - Segmenter vos clientsBack-office
Créez un type de client par niveau : Membre, Silver, Gold. Voir Types de clients.
- Déclarer vos magasinsBack-office
Ajoutez les coordonnées GPS de vos points de vente et un texte court par zone, éventuellement par plage horaire. Quand le client passe à proximité, la carte remonte sur son écran de verrouillage. Voir Localisations.
- Créer les coupons modèlesBack-office
Créez un coupon par mécanique : bienvenue (
isWelcomeCoupon), anniversaire, palier, win-back. Chaque coupon est un modèle réutilisable : nom, description, valeur, code promo, expiration, strip et format de code-barres. Le corps est enmultipart/form-data: les objets (colors,security) partent en chaîne JSON.- curl
- SDK Node.js
- nodejs
- php
- python
- java
- csharp
- go
- ruby
- CURL
curl -L 'https://api-v2.test.eldowallet.fr/coupons' \
-H 'Accept: application/json' \
-H 'x-lang: fr' \
-H 'Authorization: Bearer <token>' \
-F 'strip=@"anniversaire.png"' \
-F 'name="Anniversaire"' \
-F 'description="-20 % pendant 30 jours, pour votre anniversaire"' \
-F 'value="20%"' \
-F 'barcodeFormat="QR_CODE"' \
-F 'colors="{\"backgroundColor\":\"\#59358b\",\"labelColor\":\"\#f2fbce\",\"foregroundColor\":\"\#ffffff\"}"' \
-F 'security="{\"enableOneTimeUse\":true}"' - Embaser les clientsVotre serveur
À chaque inscription (caisse, site, application), votre CRM crée le client. eldo wallet génère sa carte. Avec
sendCard: true, eldo wallet envoie le lien d'ajout. Sinon, récupérez le lien dans la réponse et diffusez-le dans vos propres canaux. Pour une base existante, importez en masse (JSON ou CSV).- 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": "Marie",
"lastName": "Martin",
"email": "marie.martin@example.com",
"phoneNumber": "+33612345678",
"birthDate": "1990-04-12T00:00:00.000Z",
"source": "CRM",
"sendCard": true
}' - Le client ajoute sa carteClient final
Il ouvre le lien sur son téléphone. iPhone : Apple Wallet. Android : Google Wallet. Un tap, la carte est installée.
- Remonter les clients cartés dans votre CRMVotre serveur
Déclarez une URL de webhook sur le wallet : vous recevez
pass.installedetpass.uninstalled. Ou interrogez la liste des clients filtrée par statut. Vos vendeurs voient qui est « carté ». Voir Webhooks. - Créditer la cagnotte à chaque achatVotre serveur
Votre caisse scanne la carte et envoie le gain du client, par code-barres ou par identifiant. eldo wallet met la carte à jour dans le Wallet.
- curl
- SDK Node.js
- nodejs
- php
- python
- java
- csharp
- go
- ruby
- CURL
curl -L -X PATCH 'https://api-v2.test.eldowallet.fr/clients/barcode/$BARCODE/gain' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-lang: fr' \
-H 'Authorization: Bearer <token>' \
-d '{
"gain": 31.4
}' - Envoyer les coupons au bon momentVotre serveur
Anniversaire du jour, palier de 500 points atteint, client inactif depuis 60 jours : votre CRM détecte l'événement et envoie le coupon. Pour un client connu, passez son
clientId. L'envoi est asynchrone : suivez l'opération par son identifiant, ou passez unwebhookUrl.- curl
- SDK Node.js
- nodejs
- php
- python
- java
- csharp
- go
- ruby
- CURL
curl -L 'https://api-v2.test.eldowallet.fr/coupons/$COUPON_ID/passes/send' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-lang: fr' \
-H 'Authorization: Bearer <token>' \
-d '{
"clients": [
{
"clientId": "$CLIENT_ID"
},
{
"clientId": "$OTHER_CLIENT_ID",
"value": "25%"
}
],
"webhookUrl": "https://crm.example.com/hooks/eldo"
}' - Brûler le coupon en caisseVotre serveur
La caisse scanne le code-barres et valide le pass. Un second scan est refusé (
PASS_ALREADY_REDEEMED). Une erreur de scan ? Annulez la validation. Voir Cycle de vie d'un pass.- curl
- SDK Node.js
- nodejs
- php
- python
- java
- csharp
- go
- ruby
- CURL
curl -L -X POST 'https://api-v2.test.eldowallet.fr/passes/template/$COUPON_ID/redeem/$BARCODE' \
-H 'Accept: application/json' \
-H 'x-lang: fr' \
-H 'Authorization: Bearer <token>' - Animer avec les notifications et les offresBack-office
Ventes privées à tous les porteurs, ou message personnalisé par client depuis votre CRM (« Votre commande Click & Collect est prête »). Pour une opération, créez une communication : le strip de la carte change pendant la période choisie. Voir Notifications push.
- MesurerVotre serveur
Rapatriez les statistiques clients, coupons et notifications dans votre tableau de bord. Croisez-les avec votre panier moyen et votre fréquence de visite.
Scénarios prêts à l'emploi
| Scénario | Déclencheur | Appels |
|---|---|---|
| QR sur la caisse | Le client scanne un QR imprimé depuis le back-office | Aucun, sans code |
| Bouton « Carte Wallet » dans le CRM | Le vendeur clique sur la fiche client | POST/clients |
| Coupon de bienvenue | Inscription d'un client | Coupon créé avec isWelcomeCoupon |
| Joyeux anniversaire | Cron quotidien à 9 h | POST/coupons/{id}/passes/send |
| Cagnotte en direct | Ticket encaissé | PATCH/clients/barcode/{barcode}/gain |
| Ventes privées | Lancement de l'opération | POST/communications |
| Click & Collect prêt | Commande passée en « prête » | POST/push-notifications |
| On vous a perdu ? | Aucun achat depuis 60 jours | POST/coupons/{id}/passes/send |
Bonnes pratiques
- Un coupon modèle par mécanique. Ne recréez pas un coupon à chaque envoi. Créez « Anniversaire » une fois, envoyez-le chaque jour.
- Gardez la main sur le lien quand c'est utile. Avec
sendCard: false, intégrez le lien d'ajout dans votre propre email de bienvenue, votre ticket de caisse ou votre application. - Brûlez côté serveur, pas côté vendeur. La validation doit venir de la caisse, au moment du scan. C'est ce qui empêche la double utilisation.
- Respectez le consentement. Chaque notification est classée
INFORMATIVEouCOMMERCIAL. Une promotion est commerciale : elle ne part qu'aux clients qui l'acceptent. - Espacez vos notifications. Une notification utile par semaine vaut mieux que trois promotions. Le client peut désactiver les notifications du pass, voire le supprimer.
- Testez sur les deux plateformes. Le rendu diffère entre Apple Wallet et Google Wallet. Voir Apple Wallet ou Google Wallet.
Pour aller plus loin
- Modèles et passes
- Importer une base clients
- Envoyer un coupon à des non-clients
- Types de clients pour des cartes Silver, Gold, VIP
- Un pass ne se met pas à jour
- Endpoints : POST
/couponsPOST/coupons/{id}/passes/sendPATCH/clients/{id}/gainPOST/passes/template/{templateId}/redeem/{barcode}
Pour vous inspirer
Au-delà de la cagnotte et des coupons, voici des idées que nos clients du retail adorent. De quoi surprendre vos clients et les faire revenir.
Une de ces idées vous parle ? Contactez notre équipe : nous vous montrons comment la mettre en place.