# Documentation StampyWallet

> La documentation de StampyWallet, la carte de fidélité dans Apple Wallet et Google Wallet pour les commerces de proximité : le guide du commerçant, le serveur MCP et ses outils, l'API et les webhooks, et le skill « belles cartes ».

Chaque lien mène à la version Markdown de la page. La même page s'obtient aussi en demandant son adresse ordinaire avec l'en-tête `Accept: text/markdown`.

Toute la documentation en un seul fichier : [llms-full.txt](https://stampywallet.com/docs/llms-full.txt).
Le produit, les prix, les fonctionnalités et le reste du site : [llms.txt](https://stampywallet.com/llms.txt).

## Guide

### Bien démarrer

- [Bienvenue dans la documentation StampyWallet](https://stampywallet.com/docs/index.md): StampyWallet est une carte de fidélité dans Apple Wallet et Google Wallet, sans application. Ici, tout ce qu'il faut pour la créer, la faire scanner au comptoir, et la piloter depuis un assistant IA ou votre caisse.
- [Créer sa carte en 5 minutes](https://stampywallet.com/docs/guide/creer-sa-carte.md): Ouvrir son compte, choisir son type de carte, la personnaliser, l'essayer sur son téléphone et imprimer l'affichette du comptoir.
- [Les types de carte](https://stampywallet.com/docs/guide/types-de-carte.md): Une carte StampyWallet fonctionne selon l'un de trois modes, tampons, plusieurs récompenses (paliers) ou points, et chaque mode se décline en plusieurs formes.

### Au comptoir

- [Scanner une carte au comptoir](https://stampywallet.com/docs/guide/scanner.md): Poser un tampon ou des points, offrir une récompense, annuler une erreur, retrouver un client sans caméra et continuer sans réseau.
- [Votre équipe](https://stampywallet.com/docs/guide/equipe.md): Inviter vos employés et responsables, ce que chaque rôle peut faire, et suivre les tampons posés par chacun. Équipe illimitée dans toutes les formules.

### Faire revenir

- [Messages et notifications](https://stampywallet.com/docs/guide/messages.md): Écrire à vos clients sur l'écran verrouillé de leur téléphone, cibler un groupe, programmer un envoi, et laisser partir seuls les rappels, la relance et l'anniversaire.
- [Cartes cadeaux et forfaits](https://stampywallet.com/docs/guide/cartes-cadeaux-et-forfaits.md): Vendre des cartes cadeaux et des forfaits prépayés au comptoir, les envoyer dans le Wallet, puis les débiter au scan.
- [Avis Google](https://stampywallet.com/docs/guide/avis-google.md): Demander un avis Google à chaque client au bon moment, avec un lien direct vers votre fiche, sans tri ni récompense, dans les règles de Google.

## MCP et IA

### Brancher

- [Brancher un assistant IA](https://stampywallet.com/docs/mcp/brancher.md): Le serveur MCP de StampyWallet relie Claude, ChatGPT, Cursor ou un agent à votre carte de fidélité. Une adresse, aucune clé, et rien ne change sans votre accord.
- [Brancher Claude](https://stampywallet.com/docs/mcp/claude.md): Ajouter StampyWallet comme connecteur personnalisé dans Claude (web, ordinateur et mobile), puis connecter votre compte.
- [Brancher ChatGPT](https://stampywallet.com/docs/mcp/chatgpt.md): Ajouter le serveur MCP de StampyWallet comme connecteur dans ChatGPT, puis connecter votre compte StampyWallet.
- [Brancher Cursor et les agents](https://stampywallet.com/docs/mcp/cursor.md): Déclarer le serveur MCP de StampyWallet dans Cursor, Claude Code, VS Code ou tout agent compatible MCP.

### Outils sans compte

- [concevoir_carte](https://stampywallet.com/docs/mcp/outils/concevoir_carte.md): Concevoir une carte de fidélité
- [simuler_fidelite](https://stampywallet.com/docs/mcp/outils/simuler_fidelite.md): Simuler le coût d’une carte de fidélité
- [creer_commerce](https://stampywallet.com/docs/mcp/outils/creer_commerce.md): Mettre la carte de fidélité en service

### Outils avec compte

- [tableau_de_bord](https://stampywallet.com/docs/mcp/outils/tableau_de_bord.md): Tableau de bord du commerce
- [rentabilite](https://stampywallet.com/docs/mcp/outils/rentabilite.md): Ce que rapporte la carte
- [meilleurs_moments](https://stampywallet.com/docs/mcp/outils/meilleurs_moments.md): Meilleurs jours et heures
- [chercher_clients](https://stampywallet.com/docs/mcp/outils/chercher_clients.md): Chercher des clients
- [fiche_client](https://stampywallet.com/docs/mcp/outils/fiche_client.md): Fiche d’un client
- [envoyer_message](https://stampywallet.com/docs/mcp/outils/envoyer_message.md): Envoyer un message aux clients
- [lister_messages_recurrents](https://stampywallet.com/docs/mcp/outils/lister_messages_recurrents.md): Voir les messages récurrents
- [programmer_message_recurrent](https://stampywallet.com/docs/mcp/outils/programmer_message_recurrent.md): Programmer un message récurrent
- [modifier_message_recurrent](https://stampywallet.com/docs/mcp/outils/modifier_message_recurrent.md): Modifier un message récurrent
- [suspendre_message_recurrent](https://stampywallet.com/docs/mcp/outils/suspendre_message_recurrent.md): Mettre en pause un message récurrent
- [reprendre_message_recurrent](https://stampywallet.com/docs/mcp/outils/reprendre_message_recurrent.md): Reprendre un message récurrent
- [arreter_message_recurrent](https://stampywallet.com/docs/mcp/outils/arreter_message_recurrent.md): Arrêter un message récurrent
- [historique_messages](https://stampywallet.com/docs/mcp/outils/historique_messages.md): Historique des messages
- [regler_automatismes](https://stampywallet.com/docs/mcp/outils/regler_automatismes.md): Messages automatiques
- [lister_fermetures](https://stampywallet.com/docs/mcp/outils/lister_fermetures.md): Voir les congés et fermetures
- [ajouter_conges](https://stampywallet.com/docs/mcp/outils/ajouter_conges.md): Ajouter des congés
- [supprimer_conges](https://stampywallet.com/docs/mcp/outils/supprimer_conges.md): Supprimer des congés
- [regler_jours_fermes](https://stampywallet.com/docs/mcp/outils/regler_jours_fermes.md): Régler les jours fermés chaque semaine
- [avis_google](https://stampywallet.com/docs/mcp/outils/avis_google.md): Avis Google
- [voir_carte](https://stampywallet.com/docs/mcp/outils/voir_carte.md): Voir ma carte de fidélité
- [modifier_carte](https://stampywallet.com/docs/mcp/outils/modifier_carte.md): Modifier ma carte de fidélité
- [fiche_commerce](https://stampywallet.com/docs/mcp/outils/fiche_commerce.md): Fiche du commerce
- [affichette](https://stampywallet.com/docs/mcp/outils/affichette.md): Affichette et QR code
- [envoyer_affichette](https://stampywallet.com/docs/mcp/outils/envoyer_affichette.md): Recevoir l’affichette par e-mail
- [lister_equipe](https://stampywallet.com/docs/mcp/outils/lister_equipe.md): Voir l’équipe
- [inviter_membre](https://stampywallet.com/docs/mcp/outils/inviter_membre.md): Inviter un membre de l’équipe
- [changer_role_membre](https://stampywallet.com/docs/mcp/outils/changer_role_membre.md): Changer le rôle d’un membre
- [retirer_membre](https://stampywallet.com/docs/mcp/outils/retirer_membre.md): Retirer un membre de l’équipe
- [annuler_invitation](https://stampywallet.com/docs/mcp/outils/annuler_invitation.md): Annuler une invitation

## API et webhooks

### Commencer

- [L'API StampyWallet](https://stampywallet.com/docs/api.md): Ajoutez des passages, créez des clients et recevez les événements de votre carte de fidélité depuis votre caisse, votre site ou un outil sans code.
- [Authentification](https://stampywallet.com/docs/api/authentification.md): Chaque appel à l'API porte une clé secrète sw_live_, créée dans Réglages › Intégrations et montrée une seule fois. 120 requêtes par minute et par clé.
- [Erreurs et réessais](https://stampywallet.com/docs/api/erreurs.md): Le format des erreurs de l'API, tous leurs codes, et l'en-tête Idempotency-Key pour réessayer un POST sans risque de doublon.

### Référence

- [Lire le commerce](https://stampywallet.com/docs/api/commerce.md): GET /v1/commerce rend la fiche du commerce lié à la clé et les règles de sa carte de fidélité.
- [Créer un client](https://stampywallet.com/docs/api/creer-client.md): POST /v1/clients inscrit un client au programme de fidélité et rend le lien de sa carte, à lui envoyer par SMS ou e-mail.
- [Retrouver un client](https://stampywallet.com/docs/api/chercher-clients.md): GET /v1/clients retrouve un client par son téléphone, son e-mail ou le code de sa carte.
- [Lire un client](https://stampywallet.com/docs/api/lire-client.md): GET /v1/clients/:id rend un client et l'état de sa carte de fidélité, tampons, points et récompenses à offrir.
- [Ajouter un passage](https://stampywallet.com/docs/api/ajouter-passage.md): POST /v1/passages ajoute un tampon ou des points à la carte d'un client depuis votre caisse, et dit si une récompense est atteinte.
- [Annuler un passage](https://stampywallet.com/docs/api/annuler-passage.md): DELETE /v1/passages/:id retire le dernier passage d'un client, par exemple après un ticket annulé ou remboursé en caisse.
- [Offrir une récompense](https://stampywallet.com/docs/api/offrir-recompense.md): POST /v1/recompenses marque comme offerte une récompense gagnée par un client, depuis votre caisse.

### Webhooks

- [Webhooks](https://stampywallet.com/docs/api/webhooks.md): Recevez un appel HTTP signé sur votre serveur, Zapier, Make ou n8n à chaque passage, récompense ou nouvelle carte, et vérifiez sa signature HMAC.
- [Liste des événements](https://stampywallet.com/docs/api/evenements.md): Les neuf événements envoyés par les webhooks StampyWallet, quand ils partent, et le contenu exact de leur champ donnees.

### Caisses

- [Recevoir les événements de votre caisse](https://stampywallet.com/docs/api/entrants.md): POST /v1/entrants/:jeton reçoit les ventes de Square, Shopify, SumUp, Zettle ou de n'importe quel outil, et ajoute le passage au bon client.
- [Relier votre caisse](https://stampywallet.com/docs/api/relier-votre-caisse.md): Les réglages pas à pas pour que Square, Shopify, SumUp, Zettle, Zapier, Make ou n8n ajoutent un tampon à chaque vente, sans développeur.

## skill.md

- [Installer le skill « belles cartes »](https://stampywallet.com/docs/skill/index.md): Un fichier Markdown qui apprend à votre assistant IA à dessiner les cartes de fidélité d'un commerce comme nous le faisons : ses vraies images d'abord, les quatorze formes de carte, des icônes qui disent la récompense, et une relecture avant de montrer.
- [Ce que fait le skill](https://stampywallet.com/docs/skill/methode.md): Les quatorze formes de carte, les vraies images d'abord, les icônes sous licence quand les photos ne collent pas, et la relecture de chaque carte avant de la montrer.