Localisations et notifications de proximité
Le client passe devant votre magasin, sa carte apparaît sur son écran de verrouillage avec un message : « -10 % aujourd’hui chez nous ». Pas d’envoi de votre part. C’est le téléphone qui déclenche, à partir des localisations enregistrées sur le pass.
Comment ça marche
- Vous déclarez des localisations : latitude, longitude, et un texte pertinent (le message affiché).
- eldo wallet les inscrit dans les passes.
- Quand le client entre dans la zone, Apple Wallet ou Google Wallet propose le pass sur l’écran de verrouillage avec ce texte.
Les endpoints
| Besoin | Endpoint |
|---|---|
| Lister les localisations de la carte de fidélité | GET/wallet-locations |
| Ajouter une localisation | POST/wallet-locations |
| Modifier, supprimer | PATCH/wallet-locations/{id}, DELETE/wallet-locations/{id} |
| Localisations d’un événement, d’un transport, d’un hôtel | champ locations (ou location) du template : POST/events, POST/transits, POST/hotels |
- curl
- SDK Node.js
- nodejs
- php
- python
- java
- csharp
- go
- ruby
- CURL
curl -L 'https://api-v2.test.eldowallet.fr/wallet-locations' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-lang: fr' \
-H 'Authorization: Bearer <token>' \
-d '{
"latitude": 43.2965,
"longitude": 5.3698,
"relevantText": "Votre boutique du Vieux-Port est à deux pas."
}'
Messages selon l’heure
Une localisation peut porter plusieurs textes, chacun avec sa plage horaire : relevantTextList, avec relevantText, startTime et endTime.
Exemple : « Café offert avant 10 h » le matin, « Happy hour jusqu’à 19 h » l’après-midi, au même endroit.
Limites à connaître
- Un nombre maximal de localisations par wallet. Au-delà, l’API renvoie
MAX_WALLET_LOCATIONS_REACHED. Apple Wallet, de son côté, ne prend en compte que 10 localisations par pass. - Ce n’est pas un push. Le système décide d’afficher ou non le pass selon la distance, l’usage du téléphone et les réglages du client. Ne comptez pas dessus pour une information critique.
- Le client garde la main. Il peut couper les suggestions de passes sur l’écran de verrouillage dans ses réglages.
Réseau de plus de 10 points de vente
Choisissez les 10 emplacements qui comptent le plus : magasins phares, gares, centres commerciaux. Les suivants ne s’afficheront pas sur iPhone.