Relier votre caisse
Les réglages pas à pas pour que Square, Shopify, SumUp, Zettle, Zapier, Make ou n8n ajoutent un tampon à chaque vente, sans développeur.
Relier votre caisse, c'est donner à la caisse une adresse StampyWallet à appeler à chaque vente payée. Le passage s'ajoute alors tout seul à la carte du client, retrouvé par son téléphone ou son e-mail. Rien n'est requis pour démarrer : le scan au comptoir suffit, la caisse est un plus, surtout pour une carte à points.
Note : la caisse ne connaît le client que si elle a son téléphone ou son e-mail (fiche client, ticket envoyé par e-mail, commande en ligne), et le client doit déjà avoir sa carte StampyWallet : une caisse ne crée jamais de client. Une vente anonyme est ignorée : pour elle, le scan au comptoir reste le bon geste.
Dans StampyWallet, d'abord
- Ouvrez Réglages › Intégrations et choisissez Recevoir les ventes d'une caisse.
- Choisissez la caisse (Square, Shopify, SumUp, Zettle, ou « Autre » pour le format générique).
- Copiez l'adresse créée, de la forme
https://app.stampywallet.com/v1/entrants/ent_….
Puis dans votre caisse
- Ouvrez le Square Developer Dashboard, créez une application (ou ouvrez la vôtre), puis Webhooks › Subscriptions › Add subscription.
- Collez l'adresse StampyWallet comme Notification URL et cochez les événements
payment.createdetpayment.updated. - Copiez la Signature key de l'abonnement et collez-la dans Réglages › Intégrations.
- Seuls les paiements passés à
COMPLETEDcomptent.
- Dans l'administration Shopify : Paramètres › Notifications › Webhooks › Créer un webhook.
- Événement : Paiement de commande (
orders/paid), format JSON, adresse : celle de StampyWallet. - Copiez le secret affiché sous la liste des webhooks (« Vos webhooks seront signés avec… ») et collez-le dans Réglages › Intégrations.
- Le client est retrouvé par l'e-mail ou le téléphone de la commande.
- SumUp envoie ses notifications de transaction à l'adresse indiquée par une application reliée à votre compte. Depuis votre espace développeur SumUp, déclarez l'adresse StampyWallet pour les transactions réussies.
- Collez dans Réglages › Intégrations le secret de signature fourni, s'il y en a un.
- Bêta : écrivez-nous si une vente n'arrive pas, nous regardons avec vous.
- Zettle (PayPal) envoie ses événements par son API de webhooks : créez un abonnement à l'événement d'achat créé (
PurchaseCreated) vers l'adresse StampyWallet. - Collez dans Réglages › Intégrations la clé de signature de l'abonnement.
- Bêta : écrivez-nous si une vente n'arrive pas.
Sans code : Zapier, Make, n8n
Dans les deux sens : un outil sans code peut envoyer à StampyWallet les ventes d'une caisse qu'il connaît, ou recevoir les événements StampyWallet pour remplir un tableur, un CRM ou une liste d'e-mails.
Envoyer une vente à StampyWallet
- Déclencheur : votre caisse ou boutique (« New Payment », « New Order »…).
- Action : Webhooks by Zapier › POST, URL : l'adresse « Autre » (format générique), type de données : JSON.
- Corps :
{"client": {"telephone": "…"}, "montant": …, "reference": "…"}(ouemailà la place detelephone), la référence étant le numéro de la vente.
Recevoir les événements StampyWallet
- Déclencheur : Webhooks by Zapier › Catch Hook. Copiez l'adresse du hook.
- Collez-la comme point de réception dans Réglages › Intégrations (Webhooks), puis cliquez sur « Envoyer un test ».
Envoyer une vente à StampyWallet
- Module de votre caisse en déclencheur, puis module HTTP › Make a request.
- Méthode
POST, URL : l'adresse « Autre », corps JSON{"client": {"telephone": "…"}, "montant": …, "reference": "…"}, commePOST /v1/passages.
Recevoir les événements StampyWallet
- Module Webhooks › Custom webhook, copiez l'adresse.
- Collez-la comme point de réception dans Réglages › Intégrations, puis « Envoyer un test » pour que Make apprenne la structure.
Envoyer une vente à StampyWallet
- Nœud de votre caisse en déclencheur, puis nœud HTTP Request.
- Méthode
POST, URL : l'adresse « Autre », corps JSON{"client": {"telephone": "…"}, "montant": …, "reference": "…"}, commePOST /v1/passages.
Recevoir les événements StampyWallet
- Nœud Webhook (méthode POST), copiez l'adresse de production.
- Collez-la comme point de réception dans Réglages › Intégrations. Pour vérifier la signature, ajoutez un nœud Code avec l'exemple Node.js de la page Webhooks.
Une autre caisse
Si votre caisse sait appeler une adresse à chaque vente (beaucoup le font, sous le nom de « webhook » ou « notification »), utilisez l'adresse « Autre » et le format générique. Sinon, écrivez-nous depuis la page contact : nous regardons avec vous.
Questions fréquentes
Ça marche avec ma caisse ?
Les réglages sont prêts pour Square, Shopify, SumUp et Zettle. Toute autre caisse qui sait appeler une adresse à chaque vente passe par le format générique, et une caisse que Zapier, Make ou n8n connaissent peut passer par eux. Sinon, écrivez-nous : nous regardons avec vous.
Faut-il un développeur ?
Non. Vous copiez une adresse dans StampyWallet, vous la collez dans votre caisse, puis vous collez dans StampyWallet le secret de signature que la caisse vous donne, s'il y en a un.
Mon client doit-il déjà avoir sa carte ?
Oui. Une caisse ne crée jamais de client : elle retrouve la carte par le téléphone ou l'e-mail du client. Une vente anonyme est ignorée, et le scan au comptoir reste alors le bon geste.
Une vente peut-elle compter deux fois ?
Non. Chaque vente porte sa référence : si la caisse réessaie après une coupure, le passage n'est pas posé une deuxième fois.
Le raccordement de la caisse est-il compris dans mon abonnement ?
Il fait partie de la formule Croissance, à 40 € HT par mois, et il est ouvert pendant l'essai gratuit de 30 jours. Il n'est pas compris dans la formule Essentiel.
Mis à jour le