API, webhooks, Zapier et assistant IA
Pour les commerces qui ont un développeur ou un assistant IA. Rien de tout ça n’est nécessaire pour utiliser la carte.
Une API pour relier vos membres, tampons et récompenses à vos logiciels
Votre site ou votre logiciel peut lire et modifier vos membres. Les mêmes règles qu’au comptoir s’appliquent : limites de tampons et accord des clients.
Versionnée et documentée
JSON, version dans l’adresse (/v1), spécification OpenAPI, messages d’erreur en français ou en anglais.
Une clé par usage
Le propriétaire crée chaque clé et choisit ce qu’elle peut faire. La clé secrète s’affiche une seule fois ; nous n’en gardons que l’empreinte.
Coordonnées protégées
Sans la portée members.contact:read, une clé ne voit ni téléphone ni courriel : seulement l’identifiant, le prénom et les soldes.
Un jeu d’essai séparé
Une clé qui commence par test_ écrit dans des données d’essai, sans toucher une vraie carte.
Aucune écriture en double
L’en-tête Idempotency-Key est obligatoire pour ajouter un tampon : la même requête rejouée ne crédite qu’une fois.
Aucune promo par l’API
L’envoi de messages reste dans votre espace commerçant, avec son contrôle du consentement.
Des avis automatiques envoyés à votre logiciel (webhooks)
Votre logiciel est prévenu quand il se passe quelque chose, par exemple un tampon ajouté. Chaque envoi est signé (HMAC-SHA256 du corps et de l’horodatage) dans l’en-tête X-Signature ; refusez tout horodatage de plus de 5 minutes. Les envois ratés sont relancés, puis gardés avec un bouton « Rejouer ».
Événements
member.createdmember.deletedmember.mergedstamp.addedstamp.voidedreward.earnedreward.redeemedconsent.changedcard.addedcard.removed
Par défaut, les envois ne contiennent aucun renseignement personnel : ni téléphone, ni courriel.
Votre adresse doit être en HTTPS. Une adresse privée ou interne est refusée.
{
"id": "evt_exemple_01",
"type": "stamp.added",
"created": "2026-09-30T14:05:00Z",
"data": {
"member_id": "mbr_exemple_42",
"location_id": "loc_exemple_1",
"stamps": 8,
"stamps_required": 10
}
}Zapier, sans développeur
Sur invitationOffert dès l’approbation de Zapier
Si vous utilisez déjà Zapier, reliez vos membres, vos tampons et vos récompenses à une feuille de calcul, à votre courriel ou à votre comptabilité.
Déclencheurs : nouveau membre, tampon ajouté, récompense obtenue, récompense remise, consentement modifié.
Actions : créer ou mettre à jour un membre, ajouter un tampon, trouver un membre. Aucune action n’envoie de promo.
Au lancement, l’intégration est privée : nous vous envoyons le lien d’invitation sur demande. Elle devient publique dans Zapier dès son approbation.
Il vous faut votre propre compte Zapier. Zapier vous facture directement son utilisation.
Votre programme dans votre assistant IA
Reliez Claude, ChatGPT ou Cursor à votre programme, grâce à notre serveur MCP. Puis posez vos questions avec vos mots : « Combien de membres sont revenus ce mois-ci ? », « Prépare une promo pour mardi ».
Ce qu’il peut faire
- Lire vos chiffres : membres, visites, clients revenus après 30, 60 et 90 jours, par adresse.
- Préparer des brouillons de promos et de réponses aux avis, que vous relisez avant l’envoi.
- Ajouter un tampon, seulement si vous cochez cette permission.
Ce qu’il ne peut pas faire
- Envoyer un message à vos membres.
- Supprimer des données ou exporter des renseignements personnels.
- Changer les règles de votre programme.
Le propriétaire autorise la connexion et peut la couper en tout temps. Ce que l’assistant lit est traité par son fournisseur, hors de nos serveurs.
Questions des développeurs
Qui peut créer une clé ?
Où est la documentation ?
L’API coûte-t-elle plus cher ?
Sources
- Zapier, documentation « Share your integration »(s’ouvre dans un nouvel onglet)consulté le 30 septembre 2026.
- Model Context Protocol, présentation(s’ouvre dans un nouvel onglet)consulté le 30 septembre 2026.
Parlez à quelqu’un qui connaît l’API.
Une démo de 15 minutes par appel vidéo, avec vos questions techniques.