# StampyWallet Dokumentation > Die Dokumentation von StampyWallet, der digitalen Stempelkarte in Apple Wallet und Google Wallet für kleine Läden: die Anleitung für Ladeninhaber, der MCP-Server und seine Werkzeuge, die API und die Webhooks sowie der Skill „schöne Karten“. Diese Datei enthält alle Seiten von https://stampywallet.com/de/docs/ als Text. Im Zweifel gilt die Seite online. --- # Willkommen in der Dokumentation von StampyWallet StampyWallet ist eine digitale Stempelkarte in Apple Wallet und Google Wallet, ohne App. Hier finden Sie alles, um sie zu erstellen, an der Kasse zu scannen und über einen KI-Assistenten oder Ihr Kassensystem zu steuern. - [Anleitung für Ladeninhaber](https://stampywallet.com/de/docs/anleitung/karte-erstellen/) : Karte erstellen, scannen, Kunden zurückholen. - [MCP und KI-Assistenten](https://stampywallet.com/de/docs/mcp/verbinden/) : Claude, ChatGPT, Cursor: verbinden und jedes Werkzeug nutzen. - [API und Webhooks](https://stampywallet.com/de/docs/api/) : StampyWallet mit Ihrer Kasse, Ihrer Website oder Zapier verbinden. - [skill.md](https://stampywallet.com/de/docs/skill/) : Bringen Sie Ihrem Assistenten bei, schöne Karten zu gestalten. ## Schnellstart 1. **Erstellen Sie Ihre Karte.** Der Name Ihres Ladens, Ihr Kartentyp, Ihre Prämien: ein paar Minuten auf [stampywallet.com](https://stampywallet.com/de/#inscription), 30 Tage kostenlos testen. 2. **Stellen Sie den Aufsteller an die Theke.** Ihre Kunden scannen den QR-Code und die Karte landet in ihrem Wallet, ohne App. 3. **Scannen Sie bei jedem Besuch.** Mit Ihrem Telefon: Die Karte des Kunden aktualisiert sich von selbst. ## Wo Sie anfangen - Sie eröffnen Ihr Konto: [Karte in 5 Minuten erstellen](https://stampywallet.com/de/docs/anleitung/karte-erstellen/), dann [Die Kartentypen](https://stampywallet.com/de/docs/anleitung/kartentypen/). - Sie stehen an der Theke: [Eine Karte scannen](https://stampywallet.com/de/docs/anleitung/scannen/) und [Ihr Team](https://stampywallet.com/de/docs/anleitung/team/). - Sie wollen, dass Ihre Kunden wiederkommen: [Nachrichten und Benachrichtigungen](https://stampywallet.com/de/docs/anleitung/nachrichten/), [Gutscheine und Prepaid-Pakete](https://stampywallet.com/de/docs/anleitung/gutscheine-und-pakete/), [Google-Bewertungen](https://stampywallet.com/de/docs/anleitung/google-bewertungen/). - Sie arbeiten mit einer KI: [Claude, ChatGPT oder Cursor verbinden](https://stampywallet.com/de/docs/mcp/verbinden/) und der [Skill „schöne Karten“](https://stampywallet.com/de/docs/skill/). - Sie binden eine Kasse oder ein Tool an: [die API und die Webhooks](https://stampywallet.com/de/docs/api/). > **Tipp :** Diese Dokumentation gibt es auch als reinen Text für KI-Assistenten, unter [/llms.txt](https://stampywallet.com/llms.txt) und [/docs/llms-full.txt](https://stampywallet.com/de/docs/llms-full.txt). ## Häufige Fragen **Müssen meine Kunden eine App installieren?** Nein. Die Karte wird in Apple Wallet oder Google Wallet gespeichert, die schon auf ihrem Telefon sind, indem sie den QR-Code auf Ihrem Aufsteller scannen. Ohne Wallet erhält der Kunde seine Karte per E-Mail, mit einem Link zu einer Webkarte. **Was kostet StampyWallet?** Der Tarif Essential kostet 20 € zzgl. MwSt. pro Monat für einen Standort, der Tarif Wachstum 40 € zzgl. MwSt. pro Monat (automatische Nachrichten, SMS, Google-Bewertungen, API, Kassen und Webhooks) und der Tarif Netzwerk ab 90 € zzgl. MwSt. pro Monat. Die ersten 30 Tage sind kostenlos, mit allen Funktionen von Wachstum und ohne Vertragsbindung. **Brauche ich einen Entwickler?** Nein. Karte, Scannen an der Theke und Nachrichten stellen Sie in Ihrem StampyWallet-Bereich ein, ganz ohne Code. Die API brauchen Sie nur, um eine Kasse oder eine Software anzubinden, und für Square, Shopify, SumUp, Zettle, Zapier, Make und n8n erklärt die Seite [Ihre Kasse anbinden](https://stampywallet.com/de/docs/api/kasse-anbinden/) die Einstellungen Schritt für Schritt. **Brauche ich ein Tablet oder ein Lesegerät an der Theke?** Nein. Gescannt wird mit dem Telefon des Ladens, einem iPhone oder einem Android-Gerät, und jedes Teammitglied hat seinen eigenen Zugang. Source : https://stampywallet.com/de/docs/ --- # Ihre Karte in 5 Minuten erstellen Konto eröffnen, Kartentyp wählen, die Karte gestalten, auf dem eigenen Telefon testen und den Aufsteller für die Theke drucken. ## 1. Ihr Konto eröffnen Geben Sie auf [stampywallet.com](https://stampywallet.com/de/#inscription) Ihre E-Mail-Adresse ein: Sie erhalten einen sechsstelligen Code, ohne dass Sie sich ein Passwort ausdenken müssen. Sie können sich auch mit Google oder Apple anmelden. Der Test dauert **30 Tage**, kostenlos und ohne Kreditkarte, mit allen Funktionen des Tarifs Wachstum. Danach wählen Sie einen Tarif, oder eben nicht. ## 2. Ihr Laden Drei Fragen: - **Der Name des Ladens**, oben auf der Karte gedruckt. - **Ihre Branche**: Café, Bäckerei, Restaurant, Nägel und Wimpern, Kosmetikstudio, Barbershop, Geschäft oder anderes. Danach richten sich die vorgeschlagenen Prämien, der Stempel und die Farben. - **Ihr Logo**, optional (PNG oder JPEG). ## 3. Den Kartentyp wählen Drei Typen, jeweils in zwei Designs gezeigt, schon mit Ihrem Namen und in Ihren Farben: | Typ | Der Kunde bekommt | Ideal für | |---|---|---| | **Stempel** | Eine Prämie nach N Besuchen | Cafés, Bäckereien, Barbershops | | **Mehrere Prämien** | Immer bessere Prämien auf derselben Karte | Kosmetikstudios, Nagelstudios, Restaurants | | **Punkte** | Punkte bei jedem Besuch, je nachdem, was er ausgibt | Stark schwankende Einkäufe | Die Einzelheiten zu jedem Typ: [Die Kartentypen](https://stampywallet.com/de/docs/anleitung/kartentypen/). ## 4. Die Karte gestalten Der nächste Bildschirm zeigt die Karte live, während Sie sie einstellen: - **Ihre Prämien**: bis zu acht, jede mit einem Foto oder einem Symbol. - **Die Form** der Karte, **die Farbe** und **das Logo**. - **Kunden bitten, ihre Telefonnummer zu hinterlassen**, für SMS und Google-Bewertungen. Alles lässt sich später jederzeit unter **Ihre Karte** ändern: Jede Änderung wird automatisch gespeichert und erscheint auf den Telefonen Ihrer Kunden. ## 5. Auf Ihrem Telefon testen „Ihre Karte ist fertig“: Fügen Sie die Testkarte Ihrem eigenen Telefon hinzu und tippen Sie dann auf **Stempeln**. Ein echter Stempel kommt an, mit Benachrichtigung, genau wie bei einem Kunden. ## 6. Den Aufsteller drucken Laden Sie unter **Aufsteller** den QR-Code zur Anmeldung herunter: - **Thekenaufsteller (A5)** oder **kleines Format (A6)**, als druckfertiges PDF; - **nur den QR-Code**, als PNG oder SVG, für eine Speisekarte, das Schaufenster oder Canva; - **Per E-Mail an mich senden**, um ihn von einem anderen Gerät aus zu drucken. Der Aufsteller führt zur öffentlichen Seite Ihrer Karte, `stampywallet.com/rejoindre/`. Diesen Link können Sie unter **Ihre Karte › Der Link** lesbar machen (`/rejoindre/le-fournil`), etwa für Ihre Instagram-Bio oder einen Flyer. Eine Änderung macht nichts kaputt: Bereits gedruckte Aufsteller funktionieren weiter. ## Was Ihr Kunde sieht Er scannt den Aufsteller mit der Kamera seines Telefons, und eine Seite mit seiner Karte öffnet sich: - **Zu Apple Wallet hinzufügen** oder **Zu Google Wallet hinzufügen**: Sein Telefon zeigt die passende Option zuerst; - oder **die Karte per E-Mail erhalten**, mit einem Link zu einer Webkarte. Keine App, kein Konto. Standardmäßig wird nur der Vorname abgefragt. > **Was Sie vom Kunden abfragen :** Unter **Ihre Karte › Kundenanmeldung** ist jedes Feld „nicht abgefragt“, „optional“ oder „Pflicht“: Vorname, Nachname, Geburtstag (Tag und Monat, nie das Jahr), E-Mail, Telefon. Fragen Sie nur ab, was Sie brauchen: den Geburtstag für die Geburtstagsnachricht, E-Mail oder Telefon für Google-Bewertungen und SMS. > **Tipp :** Sie möchten, dass eine KI die Karte für Sie gestaltet, mit Fotos Ihres Ladens? Sehen Sie sich den [Skill „schöne Karten“](https://stampywallet.com/de/docs/skill/) und das Tool [`concevoir_carte`](https://stampywallet.com/de/docs/mcp/werkzeuge/concevoir_carte/) an. ## Häufige Fragen **Brauche ich für den Test eine Kreditkarte?** Nein. Die dreißig Tage sind kostenlos und ohne Kreditkarte: Sie erstellen Ihr Konto, legen sofort los und wählen am Ende einen Tarif, oder eben nicht. **Funktioniert die Karte auf iPhone und Android?** Ja. Auf dem iPhone landet sie in Apple Wallet, auf Android in Google Wallet: Die Anmeldeseite zeigt die passende Option zuerst. Ein Kunde ohne Wallet kann seine Karte per E-Mail erhalten, mit einem Link zu einer Webkarte. **Kann ich meine Karte nach dem Start noch ändern?** Ja, jederzeit unter **Ihre Karte**. Jede Änderung wird automatisch gespeichert und erscheint auf den Telefonen Ihrer Kunden. **Welche Daten werden von meinen Kunden abgefragt?** Standardmäßig nur der Vorname. Unter **Ihre Karte › Kundenanmeldung** können Nachname, Geburtstag (Tag und Monat, nie das Jahr), E-Mail und Telefon nicht abgefragt, optional oder Pflicht sein. **Funktionieren meine gedruckten Aufsteller noch, wenn ich den Link ändere?** Ja. Den Link unter **Ihre Karte › Der Link** lesbar zu machen, macht nichts kaputt: Bereits gedruckte Aufsteller funktionieren weiter. Source : https://stampywallet.com/de/docs/anleitung/karte-erstellen/ --- # Die Kartentypen Eine StampyWallet-Karte funktioniert in einem von drei Modi, Stempel, mehrere Prämien (Stufen) oder Punkte, und jeden Modus gibt es in mehreren Formen. ## Welcher Modus passt? | Modus | Der Kunde bekommt | Ideal für | |---|---|---| | `tampons` | Einen Stempel pro Besuch, am Ende eine Prämie | Cafés, Bäckereien, Barbershops | | `paliers` | Mehrere, immer bessere Prämien auf demselben Zähler | Kosmetikstudios, Nagelstudios, Blumenläden, Restaurants | | `points` | Punkte bei jedem Besuch, nach Betrag oder Leistung | Lebensmittelläden, Weinhandlungen, schwankende Einkäufe | > **Hinweis :** Sie können den Modus später unter **Ihre Karte › Typ ändern** wechseln. Kein Kunde verliert seinen Fortschritt: Seine Stempel bleiben auf der Karte (im Punktemodus zählen sie als Punkte). Auch Ihr Design und Ihre Farben bleiben. ## Stempel Der Klassiker der Stempelkarte aus Pappe: ein Stempel pro Besuch, am Ende eine Prämie, dann beginnt die Karte von vorn. Die Zahl der Felder reicht von 2 bis 50. ![Eine Café-Stempelkarte, erstellt von StampyWallet](https://stampywallet.com/assets/img/blog/cartes/cafe-tampons-en.webp "Eine Stempelkarte, so wie sie im Wallet des Kunden erscheint.") *Eine Stempelkarte, so wie sie im Wallet des Kunden erscheint.* Vier Formen: **Felder** (das Raster), **ohne Felder** (verstreute Stempel), **Objekte** (große Objekte mit Schatten, ideal mit dem Foto Ihres Produkts) und **Kreise**. ## Mehrere Prämien (Stufen) Bis zu acht Prämien auf demselben Zähler, zum Beispiel ein Kaffee nach 5 Besuchen, ein Croissant nach 10, ein Frühstück nach 20. Jede Stufe hat ihre Schwelle, ihre Bezeichnung und ihr Foto oder Symbol. ![Eine Bäckereikarte mit mehreren Prämien](https://stampywallet.com/assets/img/blog/cartes/boulangerie-paliers-en.webp "Eine Karte mit Stufen: jede Prämie bei ihrer Schwelle, mit ihrem Foto.") *Eine Karte mit Stufen: jede Prämie bei ihrer Schwelle, mit ihrem Foto.* Fünf Formen zusätzlich zu den Stempeln: **Weg** (ein Pfad, auf dem jeder Besuch den Kunden voranbringt), **Schaufenster** (die Prämien nebeneinander), **Medaillen**, **Füllung** (die nächste Prämie groß, die sich nach und nach einfärbt) und **Ring**. ```text title="Die KI fragen" Gestalte die Karte der Bäckerei Lehmann mit Stufen: - 5 Besuche: ein Croissant - 10 Besuche: ein Bauernbrot - 20 Besuche: ein Stück Kuchen nach Wahl ``` ```json title="JSON (concevoir_carte)" { "nom": "Bäckerei Lehmann", "mode": "paliers", "paliers": [ { "a": 5, "recompense": "Ein Croissant" }, { "a": 10, "recompense": "Ein Bauernbrot" }, { "a": 20, "recompense": "Ein Stück Kuchen nach Wahl" } ] } ``` ## Punkte Punkte bei jedem Besuch, wenn der Einkauf von Kunde zu Kunde stark schwankt. Die Prämien gibt es ab bestimmten Punkteschwellen, mit denselben fünf Formen wie bei den Stufen. ![Eine Punktekarte eines Teesalons](https://stampywallet.com/assets/img/blog/cartes/the-points-en.webp "Eine Punktekarte: Die Anzeige wächst mit dem, was der Kunde ausgibt.") *Eine Punktekarte: Die Anzeige wächst mit dem, was der Kunde ausgibt.* Unter **Ihre Karte › Weitere Einstellungen › Die Punkte**: - **Punkte pro Besuch**: der Wert, den der Scanner standardmäßig vorschlägt. - **Schnellwerte**: bis zu sechs Kurzwahlen, mit einem Tippen an der Kasse vergeben. - **Name Ihrer Punkte**: „Punkte“, „Bohnen“, „Sterne“… - **Nach Bonbetrag**: eine Anzahl Punkte pro Euro; Sie geben an der Kasse die Bonsumme ein, und die Berechnung läuft automatisch. > **Achtung :** Im Punktemodus wird der Wert bei jedem Scan an der Kasse gewählt oder kommt automatisch aus Ihrem Kassensystem über die [API](https://stampywallet.com/de/docs/api/besuch-erfassen/). ## Die Stile Sechs Kollektionen gestalten die Karte: **Essential**, **Klassisches Café**, **Botanisch**, **Trattoria**, **Atelier** und **Pass** (wie ein Apple-Wallet-Pass: großes Logo, kräftiger Hintergrund). Jede bietet mehrere Farbpaletten, und die Farbe kann auch frei gewählt werden. ## Die Regeln Unter **Ihre Karte › Weitere Einstellungen › Regeln**: - **Startstempel bei der Anmeldung**: von 0 bis 5. Eine angefangene Karte will man vollmachen. - **Gültigkeit einer Prämie**: unbegrenzt oder 1, 2, 3, 6 oder 12 Monate nach dem Erreichen. - **Ein Stempel pro…**: ein Betrag (zum Beispiel ein Stempel je 10 €). Sie geben an der Kasse die Bonsumme ein. - **Zwei Zähler**: eine Premium-Linie mit eigenem Ziel und eigener Prämie; am Scanner wählen Sie „normal“ oder „Premium“. ## Häufige Fragen **Was ist der Unterschied zwischen Stempeln, Stufen und Punkten?** Bei Stempeln bringt jeder Besuch einen Stempel, die volle Karte bringt eine Prämie, dann beginnt sie von vorn. Bei Stufen verteilen sich bis zu acht immer bessere Prämien auf demselben Zähler. Bei Punkten sammelt der Kunde Punkte nach Betrag oder Leistung, und die Prämien gibt es ab bestimmten Punkteschwellen. **Kann ich den Kartentyp später ändern?** Ja, unter **Ihre Karte › Typ ändern**. Kein Kunde verliert seinen Fortschritt: Seine Stempel bleiben auf der Karte und zählen im Punktemodus als Punkte. Auch Ihr Design und Ihre Farben bleiben. **Wie viele Felder kann eine Stempelkarte haben?** Von 2 bis 50 Felder. **Kann man einen Stempel nach Bonbetrag vergeben?** Ja. Die Regel **Ein Stempel pro…** gibt zum Beispiel einen Stempel je 10 €: Sie geben an der Kasse die Bonsumme ein. Im Punktemodus gibt **Nach Bonbetrag** eine Anzahl Punkte pro Euro. **Sind alle drei Typen im Tarif Essential enthalten?** Ja. Stempel, Punkte und Prämien in Stufen sind in allen Tarifen enthalten, schon ab Essential. Source : https://stampywallet.com/de/docs/anleitung/kartentypen/ --- # Eine Karte an der Kasse scannen Einen Stempel oder Punkte vergeben, eine Prämie einlösen, einen Fehler rückgängig machen, einen Kunden ohne Kamera finden und ohne Netz weiterarbeiten. Gescannt wird mit dem Telefon des Ladens, einem iPhone oder einem Android-Gerät, ohne Lesegerät und ohne Tablet. Jedes Teammitglied hat einen eigenen Zugang ([Ihr Team](https://stampywallet.com/de/docs/anleitung/team/)). ## Einen Stempel vergeben 1. **Öffnen Sie den Scanner.** Die Kamera startet sofort. 2. **Richten Sie sie auf die Karte des Kunden**, auf seinem Telefon (nicht auf den Aufsteller). 3. **Prüfen Sie den Bildschirm „Karte gelesen“**: Vorname und Fortschritt, zum Beispiel 7 → 8 von 10. 4. **Tippen Sie auf „Stempel vergeben“.** Die Karte des Kunden aktualisiert sich in seinem Wallet. „Das ist er nicht“ verwirft den Scan. ![Eine Karte wird an der Kasse gescannt](https://stampywallet.com/assets/img/step-scan.webp "Das Telefon des Ladens liest die Karte im Wallet des Kunden.") *Das Telefon des Ladens liest die Karte im Wallet des Kunden.* **Mehrere Stempel auf einmal**: Stellen Sie die Anzahl vor dem Scannen mit − und + ein, bis zu 50. Wenn Ihre Karte nach Betrag zählt („ein Stempel pro 10 €“), geben Sie stattdessen den Bonbetrag ein. Nach jedem Scan steht der Wert wieder auf 1. ## Punkte vergeben Bei einer Punktekarte wählen Sie den Wert vor dem Scannen: den Standardwert, einen Schnellwert oder „…“ für einen anderen. Mit der Regel „nach Bonbetrag“ wechseln Sie zu **Betrag** und geben die Summe ein: Die Punkte werden automatisch berechnet. ## Eine Prämie einlösen Bringt ein Besuch eine Prämie, zeigt der Bildschirm **Prämie erreicht**: - **Eingelöst**: Sie geben sie jetzt aus; - **Später**: Sie bleibt auf der Karte des Kunden, bereit für seinen nächsten Besuch. Sind mehrere Prämien fällig, wird die nächste sofort angezeigt. ## Einen Fehler rückgängig machen Direkt nach einem Scan bietet die untere Leiste **Rückgängig** an. - Inhaber und Verantwortliche können jederzeit den letzten Stempel eines Kunden oder eine eingelöste Prämie rückgängig machen. - Ein Mitarbeiter kann seine eigene Aktion **5 Minuten** lang rückgängig machen. - Nur der letzte Besuch lässt sich rückgängig machen. Ein Stempel, dessen Prämie schon eingelöst wurde, wird nach der Prämie zurückgenommen. - Sie können einen Grund angeben (falsche Karte, doppelt gescannt, falsche Anzahl, versehentlich eingelöst). Die Rücknahme wird unter Ihrem Namen vermerkt. ## Doppelt gescannt Standardmäßig zählen zwei Besuche desselben Kunden innerhalb von anderthalb Minuten nur einmal: „Gerade eben schon gestempelt“. Diese Frist stellen Sie unter **Einstellungen › An der Kasse › Zwei Besuche desselben Kunden** ein: immer zählen, einer pro Minute, pro fünf Minuten, pro Stunde oder pro halben Tag. ## Ohne Kamera: einen Kunden suchen **Kunden suchen** findet eine Karte über Vorname, Nachname, E-Mail, Telefonnummer oder den Code unter dem QR-Code. Dieselbe Suche findet auch Gutscheine (über ihren Code) und Prepaid-Pakete. Der Stempel läuft danach über denselben Bestätigungsbildschirm. ## Ohne Netz Antwortet das Netz nicht, wird der Stempel auf dem Telefon gespeichert („Stempel gespeichert, wird bestätigt“) und geht raus, sobald die Verbindung zurück ist, ohne doppelte Buchung. Der Scanner öffnet sich auch offline, und die Kundensuche funktioniert mit der auf dem Telefon gespeicherten Liste. > **Achtung :** Eine Prämie einlösen und einen Besuch rückgängig machen geht nur mit Netz. ## Den Scanner auf den Startbildschirm legen Installieren Sie den Scanner wie eine App: Danach öffnet er sich mit einem Tippen, im Vollbild. Auf dem Telefon des Ladens zeigt die Schaltfläche **App installieren** im Kasten „Der Scanner auf Ihrem Startbildschirm“ (Startseite Ihres Bereichs) das Video für Ihr Telefon. Die Videos (24 Sekunden, ohne Ton): - [Auf dem iPhone](https://app.stampywallet.com/static/videos/installation/iphone-en.mp4) - [Auf Android](https://app.stampywallet.com/static/videos/installation/android-en.mp4) ## Geburtstag an der Kasse Hat der Kunde Geburtstag, zeigt der Bildschirm das immer an. Ist auf seiner Karte ein Geburtstagsgeschenk offen, erscheint es mit der Schaltfläche **Angebot eingelöst** (oder mit zwei Schaltflächen, wenn der Kunde sein Geschenk selbst wählt). Siehe [Nachrichten und Benachrichtigungen](https://stampywallet.com/de/docs/anleitung/nachrichten/#anniversaire). Source : https://stampywallet.com/de/docs/anleitung/scannen/ --- # Ihr Team Mitarbeiter und Verantwortliche einladen, was jede Rolle darf, und die Stempel jedes Einzelnen verfolgen. Unbegrenztes Team in allen Tarifen. So viele Konten wie Personen an der Kasse, ohne Aufpreis, in allen Tarifen. Jeder scannt mit seinem eigenen Telefon und seinem eigenen Zugang. ## Die Rollen | Aktion | Inhaber | Verantwortlicher | Mitarbeiter | |---|---|---|---| | Karte stempeln, Prämie einlösen | Ja | Ja | Ja | | Zahlen und Kunden sehen | Ja | Ja | Nein | | Kunden anschreiben | Ja | Ja | Nein | | Karte und Einstellungen ändern | Ja | Ja | Nein | | Einladen, entfernen, Abo verwalten | Ja | Nein | Nein | Ein Mitarbeiter sieht nur den **Scanner** und sein Konto, dazu Gutscheine und Prepaid-Pakete, wenn der Laden welche verkauft. Ein Laden hat immer mindestens einen Inhaber. ## Jemanden einladen 1. **Öffnen Sie Ihr Team › Jemanden einladen** (nur Inhaber). 2. **Wählen Sie die Rolle**: Mitarbeiter oder Verantwortlicher. Fügen Sie bei Bedarf eine Notiz hinzu („Julia, Frühschicht“). 3. **Senden Sie**: Mit E-Mail-Adresse geht die Einladung per E-Mail raus; ohne E-Mail tippen Sie auf **Link erstellen** und dann **Link kopieren** und schicken ihn, wie Sie möchten. Eine Einladung gilt **vierzehn Tage**. Sie können sie erneut senden oder zurückziehen, solange sie nicht genutzt wurde. Eine Einladung als Verantwortlicher, die an eine E-Mail-Adresse geht, lässt sich nur mit dieser Adresse annehmen. ## Rolle ändern, jemanden entfernen Unter **Ihr Team** ändern Sie die Rolle eines Mitglieds oder entziehen ihm den Zugang: Seine Sitzungen werden sofort beendet. ## Auswertung pro Person **Auswertung pro Person anzeigen** zeigt über 7 oder 30 Tage die vergebenen Stempel, die eingelösten Prämien und die Rücknahmen jedes Mitglieds. > **Tipp :** Über einen verbundenen KI-Assistenten listen die Tools [`lister_equipe`](https://stampywallet.com/de/docs/mcp/werkzeuge/lister_equipe/), [`inviter_membre`](https://stampywallet.com/de/docs/mcp/werkzeuge/inviter_membre/) und [`changer_role_membre`](https://stampywallet.com/de/docs/mcp/werkzeuge/changer_role_membre/) das Team auf, laden ein und ändern Rollen, immer erst nach Ihrer Zustimmung. Source : https://stampywallet.com/de/docs/anleitung/team/ --- # Nachrichten und Benachrichtigungen Ihre Kunden auf dem Sperrbildschirm ihres Telefons erreichen, eine Gruppe gezielt ansprechen, einen Versand planen und Erinnerungen, Rückholnachricht und Geburtstagsgruß automatisch verschicken lassen. Eine Karte im Wallet kann eine Benachrichtigung auf dem Sperrbildschirm des Kunden anzeigen. Das ist kostenlos, in allen Tarifen, und genau das holt Kunden zurück. ## Eine Nachricht senden Unter **Benachrichtigungen › Nachricht senden**: - **Höchstens 180 Zeichen**, mit einer Vorschau dessen, was der Kunde sieht. Drei Vorlagen für den Anfang. - **Eine Nachricht pro Tag** und Laden, damit Ihre Kunden nicht genervt sind. - Vor dem Versand zeigt der Bildschirm, wie viele Kunden die Nachricht erhalten: diejenigen, die die Karte in einem Wallet haben. Eine Webkarte (per E-Mail erhalten) bekommt keine Benachrichtigung. **An wen**: alle Ihre Kunden, in allen Tarifen. Mit dem Tarif Wachstum auch eine Gruppe: seit 30, 60 oder 90 Tagen nicht gekommen, kurz vor der Prämie, Geburtstag in diesem Monat, beste Kunden (die 20 %, die am häufigsten kommen), neue Kunden. **Planen** (Wachstum): Wählen Sie Tag und Uhrzeit des Versands, bis zu 60 Tage im Voraus, zwischen 7 und 22 Uhr, nach der Ortszeit des Ladens. Eine geplante Nachricht lässt sich ändern, absagen oder sofort verschicken. ## Automatische Nachrichten Tarif Wachstum, unter **Einstellungen**: | Nachricht | Wann sie rausgeht | Standard | |---|---|---| | Nur noch ein Stempel | Bis zur Prämie fehlt nur noch ein Besuch | Aktiviert | | Ihre Prämie ist da | Der Kunde hat gerade eine Prämie erreicht | Aktiviert | | Die Rückholnachricht | Ein Stammkunde kommt nicht mehr | Aktiviert | | Der Geburtstag | Am Geburtstag des Kunden | Aktiviert | Die beiden Erinnerungen gehen nach dem Besuch raus, mit der gewählten Verzögerung: sofort, 30 Minuten, 1 Stunde (Standard), 3 Stunden oder am nächsten Tag. ### Kunden zurückholen, die nicht mehr kommen Ein Stammkunde gilt als „verloren“, wenn seine Abwesenheit seinen eigenen Besuchsrhythmus überschreitet oder, ohne ausreichende Historie, die Frist Ihres Ladens (je nach Branche vorgeschlagen, einstellbar). Nur Öffnungstage zählen: Tragen Sie Urlaub und Ruhetage unter **Einstellungen › Ihre Schließtage** ein, damit nach Ihrer Rückkehr niemand angeschrieben wird. Eine Rückholnachricht pro Abwesenheit; ihr Text (180 Zeichen) lässt sich ändern. ### Der Geburtstag Zum Aktivieren fragen Sie bei der Anmeldung den Geburtstag ab ([was Sie vom Kunden abfragen](https://stampywallet.com/de/docs/anleitung/karte-erstellen/)). Am Tag selbst erhält der Kunde eine Nachricht und sein Geschenk, 30 Tage gültig: - **nur eine Nachricht**; - **ein Rabatt** von 1 bis 90 % auf jeden Einkauf, 30 Tage lang; - **1 kaufen, 1 gratis**, einmalig; - **nach Wahl des Kunden**, zwischen dem Rabatt und „1 kaufen, 1 gratis“, an der Kasse gewählt. Eine Nachricht pro Person und Jahr, sofern sich der Kunde vor seinem Geburtstag angemeldet hat. Schreiben Sie nichts, geht ein vorgeschlagener Glückwunsch raus, im Namen Ihres Geschäfts und in seiner Sprache, ohne etwas zu versprechen; um nichts zu senden, schalten Sie den Geburtstag unter **Einstellungen** aus. An der Kasse zeigt der Scanner das Geschenk mit der Schaltfläche **Angebot eingelöst**. ## Ruhezeiten Standardmäßig kommt zwischen 21 und 9 Uhr keine automatische Nachricht an. Ein Versand in diesem Zeitfenster wird verschoben, nicht verworfen. ## Benachrichtigung, SMS, E-Mail - **Die Wallet-Benachrichtigung** ist kostenlos und unbegrenzt, in allen Tarifen. - **Die SMS** (Wachstum) springt ein, wenn die Karte nicht in einem Wallet liegt, für Kunden, die ihre Nummer hinterlassen haben: 200 SMS pro Monat sind inklusive, über den Monat verteilt, mit einer Reserve für wichtige Nachrichten. Keine SMS sonntags, an Feiertagen oder außerhalb von 8 bis 20 Uhr, nie mehr als drei pro Woche an dieselbe Nummer und nie Werbung an jemanden, der sie abgelehnt hat. - **Die E-Mail** dient als Ersatz für Google-Bewertungen und den Geburtstag. Der Kanal wird pro Nachrichtenart unter **Einstellungen › Nachrichten und SMS** eingestellt: automatisch (empfohlen), nur Benachrichtigung, SMS als Ersatz, SMS zuerst oder E-Mail als Ersatz. ## Was Ihre Nachrichten gebracht haben Mit dem Tarif Wachstum erhält jeder zehnte Kunde, per Los gezogen, weder Werbenachrichten noch die Rückholnachricht. Sieben Tage nach jeder Nachricht vergleicht der **Bericht**, wer in jeder Gruppe zurückgekommen ist: Der Unterschied ist das, was die Nachricht wirklich gebracht hat. ## Der Montagsbericht Jeden Montagmorgen erhält der Inhaber per E-Mail den Wochenbericht: Stempel, neue Kunden, Prämien und die Kunden, die nicht mehr kommen. Für eine Woche ohne Aktivität gibt es keinen Bericht. > **Tipp :** Über einen verbundenen KI-Assistenten: [`envoyer_message`](https://stampywallet.com/de/docs/mcp/werkzeuge/envoyer_message/) für eine Nachricht, [`regler_automatismes`](https://stampywallet.com/de/docs/mcp/werkzeuge/regler_automatismes/) für die automatischen Nachrichten, [`programmer_message_recurrent`](https://stampywallet.com/de/docs/mcp/werkzeuge/programmer_message_recurrent/) für wiederkehrende Nachrichten, [`ajouter_conges`](https://stampywallet.com/de/docs/mcp/werkzeuge/ajouter_conges/) für den Urlaub. Source : https://stampywallet.com/de/docs/anleitung/nachrichten/ --- # Gutscheine und Prepaid-Pakete Gutscheine und Prepaid-Pakete an der Kasse verkaufen, ins Wallet schicken und dann beim Scannen abbuchen. Zwei Produkte des Tarifs Wachstum, die wie die Stempelkarte im Wallet liegen. In beiden Fällen **kassieren Sie an Ihrer Kasse, wie gewohnt**: StampyWallet wickelt keine Zahlung ab und verkauft nichts online. ## Gutscheine ![Zwei Gutscheine von StampyWallet](https://stampywallet.com/assets/img/blog/cartes/cadeaux-duo-en.webp "Ein Produktgutschein und ein Wertgutschein in den Farben des Ladens.") *Ein Produktgutschein und ein Wertgutschein in den Farben des Ladens.* ### Den Verkauf vorbereiten Unter **Gutscheine › Einstellungen**: - **Produkte**, mit Preis und Foto (bis zu 24); - **Beträge** (bis zu 8), und auf Wunsch ein freier Betrag; - **die Gültigkeit**: 3, 6 oder 12 Monate nach dem Verkauf. Dann **In den Verkauf nehmen**. Der Gutschein übernimmt das Logo und die Farben Ihrer Stempelkarte. ### Verkaufen 1. **Kassieren Sie** an Ihrer Kasse. 2. **Gutschein verkaufen**: das Produkt oder der Betrag, „Für“, „Von“, ein paar persönliche Worte. Auch ein Mitarbeiter kann verkaufen. 3. **Übergeben Sie ihn**: ein QR-Code zum Scannen, ein Link zum Teilen (WhatsApp, SMS), oder StampyWallet schickt ihn per SMS oder E-Mail. Wer ihn bekommt, legt ihn in Apple Wallet oder Google Wallet ab oder behält ihn auf seiner Webseite. ### An der Kasse einlösen Scannen Sie den Gutschein oder suchen Sie seinen 8-stelligen Code: - ein **Produktgutschein**: **Einlösen**, und er ist verbraucht; - ein **Wertgutschein**: den gewünschten Betrag **abbuchen**; das Guthaben vorher und nachher wird angezeigt und im Wallet aktualisiert. Ein bereits verkaufter Gutschein bleibt in allen Tarifen gültig, auch wenn Sie den Verkauf einstellen. ## Prepaid-Pakete Zehn Sitzungen, zehn Kaffees, fünf Behandlungen: Der Kunde zahlt im Voraus, und jeder Besuch zieht eine Einheit ab. - Von 1 bis 100 Einheiten, mit einer Bezeichnung Ihrer Wahl (Sitzung, Behandlung, Kaffee…). - Bis zu 12 Paketvorlagen, gültig 1, 2, 3, 6 oder 12 Monate oder unbegrenzt. - Verkauf: kassieren, dann **Kassiert, Paket erstellen**. Der Kunde erhält sein Paket in seinem Wallet. - An der Kasse: **1 Sitzung abziehen** (oder Ihre Einheit). Der letzte Abzug lässt sich 24 Stunden lang rückgängig machen. - Das Wallet erinnert den Kunden eine Woche vor Ablauf und wenn nur noch wenige Einheiten übrig sind. Source : https://stampywallet.com/de/docs/anleitung/gutscheine-und-pakete/ --- # Google-Bewertungen Jeden Kunden im richtigen Moment um eine Google-Bewertung bitten, mit einem direkten Link zu Ihrem Profil, ohne Filter und ohne Belohnung, nach den Regeln von Google. Mit dem Tarif Wachstum bittet StampyWallet Ihre Kunden um eine Google-Bewertung, wenn sie am zufriedensten sind: bei ihrer ersten Prämie oder nach ein paar Besuchen. ## So funktioniert es - **Dieselbe Nachricht für alle**, mit dem direkten Link zu Ihrem Google-Profil. - **Keine Vorab-Bewertung**, keine Auswahl der Kunden nach ihrer Meinung, **keine Belohnung** für eine Bewertung: Das sind die Regeln von Google, und StampyWallet hält sich daran. - **Eine Anfrage pro Kunde**, nur ein einziges Mal. ## Aktivieren 1. **Fügen Sie Ihren Google-Bewertungslink** unter **Google-Bewertungen** ein. Ohne ihn geht nichts raus. Sie finden ihn in Ihrem Google-Unternehmensprofil, Schaltfläche „Bewertungen anfordern“. 2. **Fragen Sie bei der Anmeldung nach E-Mail oder Telefonnummer** ([Karte erstellen](https://stampywallet.com/de/docs/anleitung/karte-erstellen/)): Die Anfrage geht per SMS oder per E-Mail raus. 3. **Wählen Sie den Zeitpunkt**: bei der ersten Prämie (Standard) oder nach einer Anzahl von Besuchen (standardmäßig 3). 4. **Wählen Sie die Verzögerung** nach dem Besuch: sofort, 30 Minuten, 1 Stunde, 3 Stunden (Standard) oder am nächsten Tag. Die Ruhezeiten gelten. > **Hinweis :** Die Wallet-Benachrichtigung kann keinen Link enthalten. Die Anfrage geht deshalb zuerst per SMS raus (aus Ihrem Kontingent von 200 SMS pro Monat) oder per E-Mail, je nach Einstellung unter **Einstellungen › Nachrichten und SMS**. Der Link steht außerdem auf der Rückseite der Kundenkarte. ## Die Zahlen Der Bildschirm **Google-Bewertungen** zeigt die gesendeten Anfragen und die Klicks zu Google in den letzten 30 Tagen. > **Tipp :** Über einen verbundenen KI-Assistenten liest das Tool [`avis_google`](https://stampywallet.com/de/docs/mcp/werkzeuge/avis_google/) diese Zahlen und stellt die Anfrage ein. Source : https://stampywallet.com/de/docs/anleitung/google-bewertungen/ --- # Einen KI-Assistenten verbinden Der MCP-Server von StampyWallet verbindet Claude, ChatGPT, Cursor oder einen Agenten mit Ihrer Stempelkarte. Eine Adresse, kein Schlüssel, und nichts ändert sich ohne Ihre Zustimmung. StampyWallet spricht das **Model Context Protocol** (MCP), den Standard, mit dem ein KI-Assistent Tools nutzen kann. Einmal verbunden, können Sie im Gespräch fragen: „Gestalte mir eine Stempelkarte“, „Wie viele Kunden waren diesen Monat da?“, „Sag meinen Stammkunden, dass ich Montag geschlossen habe.“ ## Die Serveradresse ```text title="MCP-Server" https://app.stampywallet.com/mcp ``` „Streamable“ HTTP, JSON-Antworten, zustandslos. Mehr müssen Sie Ihrem Assistenten nicht geben. **Claude** **Einstellungen › Connectors › Benutzerdefinierten Connector hinzufügen**, Adresse einfügen. Schritt für Schritt: [Claude](https://stampywallet.com/de/docs/mcp/claude/). **ChatGPT** In 9 Ländern (Frankreich, Belgien, Schweiz, Luxemburg, Spanien, Mexiko, USA, Vereinigtes Königreich und Kanada) öffnen Sie **Plugins**, suchen „StampyWallet“ und installieren den [Eintrag](https://chatgpt.com/plugins/plugin_asdk_app_6ac3ccee239481918d9338d36fd3af94). Anderswo: **Einstellungen › Apps und Connectors**, Entwicklermodus, **Erstellen**, Adresse einfügen. Schritt für Schritt: [ChatGPT](https://stampywallet.com/de/docs/mcp/chatgpt/). **Cursor und Agenten** ```json title=".cursor/mcp.json" { "mcpServers": { "stampywallet": { "url": "https://app.stampywallet.com/mcp" } } } ``` Schritt für Schritt, auch für Claude Code: [Cursor und Agenten](https://stampywallet.com/de/docs/mcp/cursor/). ## Ohne Konto, dann mit Ihrem Konto Der Server bietet zwei Gruppen von Tools unter derselben Adresse: - **Ohne Konto**: [`concevoir_carte`](https://stampywallet.com/de/docs/mcp/werkzeuge/concevoir_carte/) gestaltet eine Karte passend zu einem Laden, [`simuler_fidelite`](https://stampywallet.com/de/docs/mcp/werkzeuge/simuler_fidelite/) rechnet aus, was sie kostet, und [`creer_commerce`](https://stampywallet.com/de/docs/mcp/werkzeuge/creer_commerce/) schaltet sie live und gibt einen Link zurück, über den man Inhaber wird. Keine Anmeldung nötig. - **Mit Ihrem Konto**: Ihre Zahlen, Ihre Kunden, Ihre Nachrichten, die Google-Bewertungen, die Karteneinstellungen, der Aufsteller, das Team. Beim ersten Aufruf öffnet der Assistent die StampyWallet-Anmeldeseite (OAuth): Sie melden sich an, wählen den Laden und erlauben den Zugriff. Auf dem Freigabebildschirm können Sie **nur lesen** ankreuzen: Der Assistent liest dann Ihre Zahlen und Einstellungen, kann aber nichts ändern. Die Zugänge verwalten Sie unter **Einstellungen › Ihre Daten › Verbundene Assistenten**, wo sich jeder Assistent mit einem Klick trennen lässt. | Berechtigung | Was sie erlaubt | |---|---| | `stampy.lecture` | Ihre Zahlen, Ihre Kunden (Vornamen), Ihre Einstellungen und Ihre Karte lesen | | `stampy.ecriture` | In Ihrem Namen handeln: Nachrichten an Kunden, Einstellungen, Karte, Team, immer erst nach Ihrer Zustimmung in der Unterhaltung | ## Nichts ändert sich ohne Ihre Zustimmung Die Tools, die schreiben, haben einen Parameter `confirmer`, standardmäßig `false`. So aufgerufen, tun sie nichts: Sie liefern eine **Vorschau** (den genauen Text einer Nachricht und die Zahl der Empfänger, den Zustand einer Einstellung vorher und nachher). Der Assistent zeigt sie Ihnen und ruft das Tool erst nach Ihrem „Ja“ mit `confirmer: true` erneut auf. > **Achtung :** Zwei Dinge gehen nur an der Kasse, durch Scannen der Kundenkarte: **Stempel vergeben** und **Prämien einlösen**. Kein MCP-Tool kann das. Um sie aus einem Kassensystem zu vergeben, gibt es die [API](https://stampywallet.com/de/docs/api/besuch-erfassen/). ## Die Tools | Tool | Konto | Wirkung | |---|---|---| | [`concevoir_carte`](https://stampywallet.com/de/docs/mcp/werkzeuge/concevoir_carte/) | Ohne | Nur lesen | | [`simuler_fidelite`](https://stampywallet.com/de/docs/mcp/werkzeuge/simuler_fidelite/) | Ohne | Nur lesen | | [`creer_commerce`](https://stampywallet.com/de/docs/mcp/werkzeuge/creer_commerce/) | Ohne | Schreibt (confirmer) | | [`tableau_de_bord`](https://stampywallet.com/de/docs/mcp/werkzeuge/tableau_de_bord/) | Mit | Nur lesen | | [`rentabilite`](https://stampywallet.com/de/docs/mcp/werkzeuge/rentabilite/) | Mit | Nur lesen | | [`meilleurs_moments`](https://stampywallet.com/de/docs/mcp/werkzeuge/meilleurs_moments/) | Mit | Nur lesen | | [`chercher_clients`](https://stampywallet.com/de/docs/mcp/werkzeuge/chercher_clients/) | Mit | Nur lesen | | [`fiche_client`](https://stampywallet.com/de/docs/mcp/werkzeuge/fiche_client/) | Mit | Nur lesen | | [`envoyer_message`](https://stampywallet.com/de/docs/mcp/werkzeuge/envoyer_message/) | Mit | Schreibt (confirmer) | | [`lister_messages_recurrents`](https://stampywallet.com/de/docs/mcp/werkzeuge/lister_messages_recurrents/) | Mit | Nur lesen | | [`programmer_message_recurrent`](https://stampywallet.com/de/docs/mcp/werkzeuge/programmer_message_recurrent/) | Mit | Schreibt (confirmer) | | [`modifier_message_recurrent`](https://stampywallet.com/de/docs/mcp/werkzeuge/modifier_message_recurrent/) | Mit | Schreibt (confirmer) | | [`suspendre_message_recurrent`](https://stampywallet.com/de/docs/mcp/werkzeuge/suspendre_message_recurrent/) | Mit | Schreibt (confirmer) | | [`reprendre_message_recurrent`](https://stampywallet.com/de/docs/mcp/werkzeuge/reprendre_message_recurrent/) | Mit | Schreibt (confirmer) | | [`arreter_message_recurrent`](https://stampywallet.com/de/docs/mcp/werkzeuge/arreter_message_recurrent/) | Mit | Schreibt (confirmer) | | [`historique_messages`](https://stampywallet.com/de/docs/mcp/werkzeuge/historique_messages/) | Mit | Nur lesen | | [`regler_automatismes`](https://stampywallet.com/de/docs/mcp/werkzeuge/regler_automatismes/) | Mit | Schreibt (confirmer) | | [`lister_fermetures`](https://stampywallet.com/de/docs/mcp/werkzeuge/lister_fermetures/) | Mit | Nur lesen | | [`ajouter_conges`](https://stampywallet.com/de/docs/mcp/werkzeuge/ajouter_conges/) | Mit | Schreibt (confirmer) | | [`supprimer_conges`](https://stampywallet.com/de/docs/mcp/werkzeuge/supprimer_conges/) | Mit | Schreibt (confirmer) | | [`regler_jours_fermes`](https://stampywallet.com/de/docs/mcp/werkzeuge/regler_jours_fermes/) | Mit | Schreibt (confirmer) | | [`avis_google`](https://stampywallet.com/de/docs/mcp/werkzeuge/avis_google/) | Mit | Schreibt (confirmer) | | [`voir_carte`](https://stampywallet.com/de/docs/mcp/werkzeuge/voir_carte/) | Mit | Nur lesen | | [`modifier_carte`](https://stampywallet.com/de/docs/mcp/werkzeuge/modifier_carte/) | Mit | Schreibt (confirmer) | | [`fiche_commerce`](https://stampywallet.com/de/docs/mcp/werkzeuge/fiche_commerce/) | Mit | Schreibt (confirmer) | | [`affichette`](https://stampywallet.com/de/docs/mcp/werkzeuge/affichette/) | Mit | Nur lesen | | [`envoyer_affichette`](https://stampywallet.com/de/docs/mcp/werkzeuge/envoyer_affichette/) | Mit | Schreibt (confirmer) | | [`lister_equipe`](https://stampywallet.com/de/docs/mcp/werkzeuge/lister_equipe/) | Mit | Nur lesen | | [`inviter_membre`](https://stampywallet.com/de/docs/mcp/werkzeuge/inviter_membre/) | Mit | Schreibt (confirmer) | | [`changer_role_membre`](https://stampywallet.com/de/docs/mcp/werkzeuge/changer_role_membre/) | Mit | Schreibt (confirmer) | | [`retirer_membre`](https://stampywallet.com/de/docs/mcp/werkzeuge/retirer_membre/) | Mit | Schreibt (confirmer) | | [`annuler_invitation`](https://stampywallet.com/de/docs/mcp/werkzeuge/annuler_invitation/) | Mit | Schreibt (confirmer) | Die Tools, die ein Konto brauchen, richten sich auch nach Ihrer Rolle: Ein Mitarbeiter hat auf keines Zugriff, und die Team-Tools [`lister_equipe`](https://stampywallet.com/de/docs/mcp/werkzeuge/lister_equipe/), [`inviter_membre`](https://stampywallet.com/de/docs/mcp/werkzeuge/inviter_membre/), [`changer_role_membre`](https://stampywallet.com/de/docs/mcp/werkzeuge/changer_role_membre/), [`retirer_membre`](https://stampywallet.com/de/docs/mcp/werkzeuge/retirer_membre/) und [`annuler_invitation`](https://stampywallet.com/de/docs/mcp/werkzeuge/annuler_invitation/) sind dem Inhaber vorbehalten. Schließlich richten sie sich nach Ihrem Tarif (manche Zahlen und die Google-Bewertungen setzen Wachstum voraus). ## Von Hand ausprobieren Der Server antwortet jedem MCP-Client, oder `curl`: ```bash title="curl" curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ``` Ohne Konto sind die Aufrufe pro IP-Adresse begrenzt: Darüber hinaus bittet der Server, ein paar Minuten zu warten. ## Häufige Fragen **Brauche ich einen Schlüssel, um den MCP-Server zu verbinden?** Nein, keinen Schlüssel. Die Tools ohne Konto funktionieren sofort; für Ihre Zahlen und Ihre Kunden lässt Sie der Assistent beim ersten Aufruf Ihr StampyWallet-Konto verbinden. **Funktioniert das mit dem kostenlosen ChatGPT?** Bei StampyWallet kostet das Verbinden des Servers nichts, und die Tools ohne Konto stehen allen offen. Bei ChatGPT wird StampyWallet in diesen 9 Ländern über die **Plugins** installiert, ohne Entwicklermodus. Anderswo wird der Connector im Entwicklermodus erstellt, dessen Verfügbarkeit von Ihrem ChatGPT-Abo abhängt. Bietet Ihres ihn nicht an, verbinden sich Claude, Cursor oder jeder andere MCP-Client über dieselbe Adresse. **Kann der Assistent etwas ohne meine Zustimmung ändern?** Nein. Die Tools, die schreiben, liefern zuerst eine Vorschau, und der Assistent ruft sie erst nach Ihrem „Ja“ mit `confirmer: true` erneut auf. Sie können auch nur Lesezugriff erlauben. **Kann der Assistent Stempel vergeben?** Nein. Stempel vergeben und Prämien einlösen geht nur an der Kasse, durch Scannen der Kundenkarte. Aus einem Kassensystem erledigt das der API-Endpunkt [Besuch hinzufügen](https://stampywallet.com/de/docs/api/besuch-erfassen/). **Wie entziehe ich einem Assistenten den Zugriff?** Unter **Einstellungen › Ihre Daten › Verbundene Assistenten**: Jeder Assistent lässt sich mit einem Klick trennen. Source : https://stampywallet.com/de/docs/mcp/verbinden/ --- # Claude verbinden StampyWallet als benutzerdefinierten Connector in Claude hinzufügen (Web, Desktop und Mobil) und dann Ihr Konto verbinden. 1. **Öffnen Sie Claude** (claude.ai oder die Desktop-App) und dann **Einstellungen › Connectors**. 2. **Benutzerdefinierten Connector hinzufügen.** Name: `StampyWallet`. Adresse: `https://app.stampywallet.com/mcp`. 3. **Aktivieren Sie ihn in einer Unterhaltung**, über das Tool-Menü unter dem Eingabefeld. 4. **Fragen Sie**: „Gestalte die Stempelkarte meines Cafés, Café Lindenblatt, 8 Kaffees gekauft, der 9. gratis.“ Claude ruft [`concevoir_carte`](https://stampywallet.com/de/docs/mcp/werkzeuge/concevoir_carte/) auf und zeigt Ihnen die Karte. 5. **Für Ihre Zahlen und Ihre Kunden** bietet Claude Ihnen an, sich anzumelden: Die StampyWallet-Seite öffnet sich, Sie wählen den Laden und erlauben den Zugriff. Bei einem Team-Abo kann das Hinzufügen eines benutzerdefinierten Connectors den Administratoren der Organisation vorbehalten sein. ## Mit dem Skill Fügen Sie auch den [Skill „schöne Karten“](https://stampywallet.com/de/docs/skill/) hinzu: Claude sucht dann echte Fotos des Ladens und schlägt mindestens zwölf Versionen der Karte vor, über alle Typen hinweg. ## Beispielanfragen - „Wie viele Kunden waren diesen Monat da, und ist das mehr als im letzten Monat?“ ([`tableau_de_bord`](https://stampywallet.com/de/docs/mcp/werkzeuge/tableau_de_bord/)) - „Welche Stammkunden kommen nicht mehr?“ ([`chercher_clients`](https://stampywallet.com/de/docs/mcp/werkzeuge/chercher_clients/)) - „Sag allen meinen Kunden, dass ich vom 24. bis 31. Dezember geschlossen habe.“ ([`ajouter_conges`](https://stampywallet.com/de/docs/mcp/werkzeuge/ajouter_conges/)) - „Stell meine Karte auf Stufen um: ein Kaffee bei 5, ein Croissant bei 10.“ ([`modifier_carte`](https://stampywallet.com/de/docs/mcp/werkzeuge/modifier_carte/)) Source : https://stampywallet.com/de/docs/mcp/claude/ --- # ChatGPT verbinden StampyWallet aus den Plugins von ChatGPT installieren oder über seine MCP-Adresse hinzufügen und dann Ihr StampyWallet-Konto verbinden. StampyWallet ist im Plugin-Katalog von ChatGPT in 9 Ländern veröffentlicht (Frankreich, Belgien, Schweiz, Luxemburg, Spanien, Mexiko, USA, Vereinigtes Königreich und Kanada): [zum StampyWallet-Eintrag](https://chatgpt.com/plugins/plugin_asdk_app_6ac3ccee239481918d9338d36fd3af94). 1. **Öffnen Sie Plugins.** In ChatGPT finden Sie sie im linken Menü. 2. **Suchen Sie „StampyWallet“.** Öffnen Sie den Eintrag und tippen Sie auf **Installieren**. 3. **Nutzen Sie es in einer Unterhaltung.** Fügen Sie StampyWallet über das Menü „+“ hinzu und fragen Sie dann: „Gestalte die Stempelkarte meiner Bäckerei.“ 4. **Verbinden Sie Ihr Konto.** Für Ihre Zahlen und Ihre Kunden zeigt ChatGPT **Anmelden** an: Die StampyWallet-Seite öffnet sich, Sie wählen den Laden und erlauben den Zugriff. > **Hinweis :** In ChatGPT erscheinen manche Tools mit einer eigenen Ansicht (die gerenderte Karte, die Zahlen). Überall sonst funktionieren dieselben Tools mit Text und Daten. ## Über die Adresse hinzufügen Außerhalb dieser Länder, also auch in Deutschland, oder wenn der Eintrag in Ihrem Konto nicht erscheint, fügen Sie den Server von Hand hinzu: 1. **Öffnen Sie die Einstellungen.** In ChatGPT im Web: **Einstellungen › Apps und Connectors**. 2. **Aktivieren Sie den Entwicklermodus.** Er steht in den erweiterten Einstellungen (je nach Abo ist er den Administratoren des Workspace vorbehalten). 3. **Erstellen Sie einen Connector.** Name: `StampyWallet`. Adresse des MCP-Servers: `https://app.stampywallet.com/mcp`. Authentifizierung: OAuth. 4. **Nutzen Sie ihn in einer Unterhaltung.** Fügen Sie StampyWallet über das Menü „+“ hinzu und verbinden Sie dann Ihr Konto wie oben. ## In einem ChatGPT-Projekt Fügen Sie den Inhalt der [skill.md](https://stampywallet.com/de/docs/skill/) in die Anweisungen eines Projekts ein: Jede Unterhaltung im Projekt folgt dann der Methode für schöne Karten. Source : https://stampywallet.com/de/docs/mcp/chatgpt/ --- # Cursor und Agenten verbinden Den MCP-Server von StampyWallet in Cursor, Claude Code, VS Code oder einem beliebigen MCP-kompatiblen Agenten eintragen. Jeder MCP-Client, der „streamable“ HTTP spricht, verbindet sich über dieselbe Adresse: `https://app.stampywallet.com/mcp`. Die Anmeldung am Konto läuft über OAuth (dynamische Registrierung, PKCE): Der Client öffnet die StampyWallet-Seite in Ihrem Browser beim ersten Tool, das sie braucht. **Cursor** Unter **Cursor Settings › MCP › Add new MCP server** oder in der Projektdatei: ```json title=".cursor/mcp.json" { "mcpServers": { "stampywallet": { "url": "https://app.stampywallet.com/mcp" } } } ``` **Claude Code** ```bash title="Terminal" claude mcp add --transport http stampywallet https://app.stampywallet.com/mcp ``` Dann `/mcp` in Claude Code, um sich mit Ihrem Konto zu verbinden. **VS Code** ```json title=".vscode/mcp.json" { "servers": { "stampywallet": { "type": "http", "url": "https://app.stampywallet.com/mcp" } } } ``` **Anderer Agent** Tragen Sie einen entfernten MCP-Server vom Typ HTTP mit der Adresse `https://app.stampywallet.com/mcp` ein. Die OAuth-Metadaten werden unter `https://app.stampywallet.com/.well-known/oauth-protected-resource` veröffentlicht. ## Ein Agent, der Karten gestaltet Geben Sie dem Agenten die Rohadresse des Skills, `https://stampywallet.com/de/docs/skill.md`, und fragen Sie: „Lies diesen Skill und gestalte dann die Stempelkarten für diesen Laden: [Name, Stadt, Instagram-Link].“ Siehe [skill.md](https://stampywallet.com/de/docs/skill/). Source : https://stampywallet.com/de/docs/mcp/cursor/ --- # concevoir_carte Ohne Konto · Nur Lesen. Gestaltet eine StampyWallet-Kundenkarte (Apple Wallet und Google Wallet) für einen Laden, ohne Konto und ohne etwas zu speichern. Verwenden, wenn jemand eine Stempelkarte möchte, seine Kunden binden will oder sehen möchte, wie seine Karte aussehen würde. Alle Parameter sind optional: Ohne sie wird eine Karte passend zur Branche vorgeschlagen. Das Logo (logo_url) und das Foto jeder Prämie (paliers[].image_url) werden über ihre https-Adresse übergeben; sie werden in der Vorschau gezeigt, ohne gespeichert zu werden. Das Werkzeug mit den zurückgegebenen, angepassten Einstellungen erneut aufrufen, um zu verfeinern. Ist die Person zufrieden, creer_commerce mit denselben Einstellungen vorschlagen. ## Parameter - `nom` (string, ≤ 80 Zeichen, optional) : Name des Ladens, oben auf die Karte gedruckt. - `metier` (enum, optional) : Art des Ladens. Wählt einen passenden Stil, Stempel und eine passende Start-Prämie, wenn diese nicht angegeben sind. ongles: Nägel und Wimpern; institut: Kosmetik; barbier: Barbershops und Friseure; patisserie: Konditorei und Chocolaterie; snack: Döner, Burger; sushi: Sushi und Poke; vrac: Unverpackt-Laden; cordonnerie: Schuhmacher und Schlüsseldienst; lavage: Autowäsche; toilettage: Hundesalon; sport: Fitnessstudio; loisirs: Escape Room, Bowling, Lasertag. „autre“: alles, was keine eigene Branche hat. Werte : cafe, boulangerie, patisserie, glacier, restaurant, creperie, sushi, snack, foodtruck, boucherie, fromagerie, primeur, vrac, ongles, institut, barbier, boutique, fleuriste, librairie, animalerie, pressing, cordonnerie, laverie, lavage, toilettage, sport, escalade, loisirs, autre. - `mode` (enum, optional) : tampons: eine Prämie bei einer Schwelle (am einfachsten). paliers: mehrere Prämien auf derselben Karte (z. B. 5 und 10). points: Der Ladeninhaber gibt bei jedem Besuch eine Anzahl Punkte ein (unterschiedliche Einkaufsbeträge). Werte : tampons, paliers, points. - `recompense` (string, ≤ 120 Zeichen, optional) : Die Prämie (Modus tampons). Wird ignoriert, wenn „paliers“ angegeben ist. - `tampons` (integer, 2…30, optional) : Anzahl der Besuche bis zur Prämie (Modus tampons), von 2 bis 30. - `paliers` (array, ≤ 6, optional) : Die Prämien und ihre Schwellen (Modi paliers und points). Von der kleinsten zur größten. - `paliers[].a` (integer, 1…1000000, Pflicht) : Schwelle: Anzahl Stempel (oder Punkte im Modus points), um diese Stufe zu erreichen. - `paliers[].recompense` (string, ≤ 120 Zeichen, Pflicht) : Was der Kunde bekommt, so wie es auf der Karte steht. Z. B. „Ein Kaffee gratis“. - `paliers[].icone` (enum, optional) : Icon der Stufe (Standard: cadeau). Werte : etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette, cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau, feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion, croissant. - `paliers[].image_url` (string, ≤ 2000 Zeichen, optional) : Foto der Prämie, über seine https-Adresse (PNG, JPEG oder WebP, höchstens 5 MB, mindestens 64 px Seitenlänge). Wenn möglich freigestellt, ersetzt es das Icon auf der Karte: grau, bevor die Prämie verdient ist, danach farbig. Wird in den Modi paliers und points gezeichnet. - `collection` (enum, optional) : Stil der Karte: original (schlicht), cafe (feiner Rahmen), botanique (kursiv, Blätter), trattoria (gewellter Rand), atelier (modern), pass (wie ein Apple Wallet Pass: großes Logo, Stempel als Objekte mit Schatten, kräftiger Hintergrund). Werte : original, cafe, botanique, trattoria, atelier, pass. - `palette` (integer, 0…3, optional) : Palette der Kollektion: 0, 1 oder 2 (jede Kollektion bietet drei; pass bietet eine vierte, 3). Wird ignoriert, wenn „couleur“ angegeben ist. - `couleur` (string, optional) : Freie Hintergrundfarbe, hexadezimal. Die Schriftfarbe (Text) wird automatisch so gewählt, dass sie lesbar bleibt. - `tampon` (enum, optional) : Das Zeichen, das bei jedem Besuch gesetzt wird. „rond“: der einfache Punkt. Beauty: etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette. Food: cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau. Sonstiges: feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion. Werte : rond, etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette, cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau, feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion, croissant. - `tampons_bienvenue` (integer, 0…5, optional) : Stempel, die der Kunde bei der Anmeldung geschenkt bekommt (0 bis 5). Standard 1: Eine angefangene Karte will man vollmachen. - `nom_des_points` (string, ≤ 20 Zeichen, optional) : Modus points: wie die Punkte heißen („Punkte“, „Bohnen“, „Sterne“…). - `forme_paliers` (enum, optional) : Modus paliers: das Aussehen der Karte. tampons (Standard): die Stempel im Raster, jede Prämie an der Stelle des Stempels ihrer Schwelle. Oder eine der fünf Formen der Punkte, die dann Stempel zählt: medailles (ein Balken und eine Medaille pro Prämie), vitrine (die Prämien nebeneinander, jede mit eigenem Balken), remplissage (die nächste Prämie in groß, die sich einfärbt), chemin (ein Weg in S-Form, auf dem jeder Stempel den Marker voranbringt), anneau (ein runder Balken um die nächste Prämie). Die Fotos der Prämien laden Sie in der App hoch, Seite Karte. Werte : tampons, medailles, vitrine, remplissage, chemin, anneau. - `forme_points` (enum, optional) : Modus points: das Aussehen der Karte. medailles (Standard): ein dicker Balken und eine große Medaille pro Prämie. vitrine: die Prämien nebeneinander, jede mit eigenem kleinen Balken. remplissage: die nächste Prämie in groß, die sich nach und nach einfärbt. chemin: ein Weg in S-Form, die Prämien als Etappen. anneau: ein runder Balken um die nächste Prämie, die Liste daneben. Die Fotos der Prämien laden Sie in der App hoch, Seite Karte. Werte : medailles, vitrine, remplissage, chemin, anneau. - `forme` (enum, optional) : Das Aussehen der Karte, in einem Wort (ersetzt forme_points und forme_paliers). Modi points und paliers: medailles (ein Balken und eine große Medaille pro Prämie), vitrine (die Prämien nebeneinander, jede mit eigenem Balken), remplissage (die nächste Prämie in groß, die sich einfärbt), chemin (ein Weg in S-Form, jeder Besuch bringt den Marker voran), anneau (ein runder Balken um die nächste Prämie). Modi tampons und paliers: die Anordnung der Stempel, grille (Standard), libre (verstreut), objets (große Objekte mit Schatten, ideal mit einem Foto), cercles. Bei paliers behält eine Anordnung die Stempel und setzt jede Prämie an die Stelle des Stempels ihrer Schwelle. Eine der fünf Formen ohne angegebenen Modus stellt die Karte auf den Modus paliers um. Werte : medailles, vitrine, remplissage, chemin, anneau, grille, libre, objets, cercles. - `encre` (string, optional) : Textfarbe der Karte, hexadezimal (Standard: so gewählt, dass sie auf dem Hintergrund lesbar bleibt). - `accent` (string, optional) : Akzentfarbe: gesetzte Stempel, Balken, Etiketten, hexadezimal (Standard: aus der Kollektion). - `logo_url` (string, ≤ 2000 Zeichen, optional) : Logo des Ladens, über seine https-Adresse (PNG, JPEG oder WebP, höchstens 5 MB): Sein Instagram-Profilbild reicht. Wenn möglich freigestellt, oben auf die Karte gesetzt; ohne Angabe von couleur, palette, encre oder accent übernimmt die Karte die Farben des Logos. - `variantes` (boolean, optional) : true: erzeugt zusätzlich die drei Paletten der gewählten Kollektion, um eine Auswahl anzubieten. Standard : false. - `tampons_poses` (integer, 0…1000000, optional) : Bereits gesetzte Stempel in der Vorschau, um eine angefangene Karte zu zeigen (Standard: Willkommensstempel + 2). ## Antwort Ein PNG-Bild der Karte (`content`, Typ `image`), ein Text, der die getroffenen Entscheidungen zusammenfasst, und die Einstellungen als Daten (`structuredContent`), die Sie angepasst zum Verfeinern oder unverändert an `creer_commerce` übergeben. Mit `variantes: true` ein zusätzliches Bild pro Palette der Kollektion. > **Tipp :** Dieses Werkzeug funktioniert ohne Konto und ohne Anmeldung. Geben Sie Ihrem Assistenten die [skill.md](https://stampywallet.com/de/docs/skill/), damit er mehrere Versionen der Karte vorschlägt. ## Beispiel Prompt : « Gestalte die Stempelkarte der Boulangerie Lemaire: 10 Besuche, das 10. Baguette gratis, Stil Pass, mit ihrem Logo. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "concevoir_carte", "arguments": { "nom": "Boulangerie Lemaire", "metier": "boulangerie", "mode": "tampons", "tampons": 10, "recompense": "Das 10. Baguette gratis", "collection": "pass", "logo_url": "https://example.com/logo-lemaire.png", "variantes": true } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"concevoir_carte","arguments":{"nom":"Boulangerie Lemaire","metier":"boulangerie","mode":"tampons","tampons":10,"recompense":"Das 10. Baguette gratis","collection":"pass","logo_url":"https://example.com/logo-lemaire.png","variantes":true}}}' ``` Source : https://stampywallet.com/de/docs/mcp/werkzeuge/concevoir_carte/ --- # simuler_fidelite Ohne Konto · Nur Lesen. Schätzt, was eine Stempelkarte kostet (die Prämie im Verhältnis zum Einkauf) und wie viele zusätzliche Besuche sie rentabel machen. Verwenden, um eine Prämie und eine Anzahl Besuche festzulegen, oder wenn sich jemand fragt, ob sich eine Karte lohnt. Ohne Konto. ## Parameter - `panier_moyen` (number, 0.5…10000, Pflicht) : Durchschnittliche Ausgabe eines Kunden pro Besuch, in Euro. - `cout_recompense` (number, 0…10000, Pflicht) : Was die Prämie den LADENINHABER kostet (Selbstkosten, nicht Verkaufspreis), in Euro. - `tampons` (integer, 2…30, Pflicht) : Besuche bis zur Prämie. - `tampons_bienvenue` (integer, 0…5, optional) : Stempel, die bei der Anmeldung geschenkt werden. Standard : 1. - `marge` (number, 1…100, optional) : Bruttomarge pro Einkauf, in Prozent (Standard 65 %, typisch für Gastronomie und Dienstleistungen). Standard : 65. - `clients_fideles` (integer, 1…100000, optional) : Kunden, die die Karte pro Monat nehmen würden (Standard 60). Standard : 60. - `visites_par_mois` (number, 0.1…60, optional) : Besuche pro Monat eines Stammkunden heute (Standard 2). Standard : 2. - `comparer` (array, ≤ 5, optional) : Andere Besuchszahlen zum Vergleich (z. B. [6, 10, 12]). ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Tipp :** Dieses Werkzeug funktioniert ohne Konto und ohne Anmeldung. Geben Sie Ihrem Assistenten die [skill.md](https://stampywallet.com/de/docs/skill/), damit er mehrere Versionen der Karte vorschlägt. ## Beispiel Prompt : « Mein Durchschnittsbon liegt bei 6 €, ein Kaffee kostet mich 0,40 €. Was kostet eine Karte mit 10 Besuchen, und ist sie mit 8 oder 12 besser? » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "simuler_fidelite", "arguments": { "panier_moyen": 6, "cout_recompense": 0.4, "tampons": 10, "comparer": [ 8, 12 ] } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"simuler_fidelite","arguments":{"panier_moyen":6,"cout_recompense":0.4,"tampons":10,"comparer":[8,12]}}}' ``` Source : https://stampywallet.com/de/docs/mcp/werkzeuge/simuler_fidelite/ --- # creer_commerce Ohne Konto · Schreibt (bestätigen). Legt den Laden in StampyWallet mit der gestalteten Karte an (gleiche Parameter wie concevoir_carte) und liefert einen persönlichen Link, um Inhaber zu werden: Die Person klickt, meldet sich mit ihrer E-Mail an und findet alles fertig vor (Karte, QR-Code zum Ausdrucken, kostenloser Testzeitraum). Das Logo (logo_url) und das Foto jeder Prämie (paliers[].image_url), über ihre https-Adresse angegeben, kommen auf die Karte. Ohne Konto. Zuerst mit confirmer=false aufrufen, um die Zusammenfassung zu zeigen, dann mit confirmer=true, sobald die Person Ja gesagt hat. ## Parameter - `nom` (string, ≤ 80 Zeichen, Pflicht) : Name des Ladens, oben auf die Karte gedruckt. - `metier` (enum, optional) : Art des Ladens. Wählt einen passenden Stil, Stempel und eine passende Start-Prämie, wenn diese nicht angegeben sind. ongles: Nägel und Wimpern; institut: Kosmetik; barbier: Barbershops und Friseure; patisserie: Konditorei und Chocolaterie; snack: Döner, Burger; sushi: Sushi und Poke; vrac: Unverpackt-Laden; cordonnerie: Schuhmacher und Schlüsseldienst; lavage: Autowäsche; toilettage: Hundesalon; sport: Fitnessstudio; loisirs: Escape Room, Bowling, Lasertag. „autre“: alles, was keine eigene Branche hat. Werte : cafe, boulangerie, patisserie, glacier, restaurant, creperie, sushi, snack, foodtruck, boucherie, fromagerie, primeur, vrac, ongles, institut, barbier, boutique, fleuriste, librairie, animalerie, pressing, cordonnerie, laverie, lavage, toilettage, sport, escalade, loisirs, autre. - `mode` (enum, optional) : tampons: eine Prämie bei einer Schwelle (am einfachsten). paliers: mehrere Prämien auf derselben Karte (z. B. 5 und 10). points: Der Ladeninhaber gibt bei jedem Besuch eine Anzahl Punkte ein (unterschiedliche Einkaufsbeträge). Werte : tampons, paliers, points. - `recompense` (string, ≤ 120 Zeichen, optional) : Die Prämie (Modus tampons). Wird ignoriert, wenn „paliers“ angegeben ist. - `tampons` (integer, 2…30, optional) : Anzahl der Besuche bis zur Prämie (Modus tampons), von 2 bis 30. - `paliers` (array, ≤ 6, optional) : Die Prämien und ihre Schwellen (Modi paliers und points). Von der kleinsten zur größten. - `paliers[].a` (integer, 1…1000000, Pflicht) : Schwelle: Anzahl Stempel (oder Punkte im Modus points), um diese Stufe zu erreichen. - `paliers[].recompense` (string, ≤ 120 Zeichen, Pflicht) : Was der Kunde bekommt, so wie es auf der Karte steht. Z. B. „Ein Kaffee gratis“. - `paliers[].icone` (enum, optional) : Icon der Stufe (Standard: cadeau). Werte : etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette, cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau, feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion, croissant. - `paliers[].image_url` (string, ≤ 2000 Zeichen, optional) : Foto der Prämie, über seine https-Adresse (PNG, JPEG oder WebP, höchstens 5 MB, mindestens 64 px Seitenlänge). Wenn möglich freigestellt, ersetzt es das Icon auf der Karte: grau, bevor die Prämie verdient ist, danach farbig. Wird in den Modi paliers und points gezeichnet. - `collection` (enum, optional) : Stil der Karte: original (schlicht), cafe (feiner Rahmen), botanique (kursiv, Blätter), trattoria (gewellter Rand), atelier (modern), pass (wie ein Apple Wallet Pass: großes Logo, Stempel als Objekte mit Schatten, kräftiger Hintergrund). Werte : original, cafe, botanique, trattoria, atelier, pass. - `palette` (integer, 0…3, optional) : Palette der Kollektion: 0, 1 oder 2 (jede Kollektion bietet drei; pass bietet eine vierte, 3). Wird ignoriert, wenn „couleur“ angegeben ist. - `couleur` (string, optional) : Freie Hintergrundfarbe, hexadezimal. Die Schriftfarbe (Text) wird automatisch so gewählt, dass sie lesbar bleibt. - `tampon` (enum, optional) : Das Zeichen, das bei jedem Besuch gesetzt wird. „rond“: der einfache Punkt. Beauty: etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette. Food: cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau. Sonstiges: feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion. Werte : rond, etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette, cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau, feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion, croissant. - `tampons_bienvenue` (integer, 0…5, optional) : Stempel, die der Kunde bei der Anmeldung geschenkt bekommt (0 bis 5). Standard 1: Eine angefangene Karte will man vollmachen. - `nom_des_points` (string, ≤ 20 Zeichen, optional) : Modus points: wie die Punkte heißen („Punkte“, „Bohnen“, „Sterne“…). - `forme_paliers` (enum, optional) : Modus paliers: das Aussehen der Karte. tampons (Standard): die Stempel im Raster, jede Prämie an der Stelle des Stempels ihrer Schwelle. Oder eine der fünf Formen der Punkte, die dann Stempel zählt: medailles (ein Balken und eine Medaille pro Prämie), vitrine (die Prämien nebeneinander, jede mit eigenem Balken), remplissage (die nächste Prämie in groß, die sich einfärbt), chemin (ein Weg in S-Form, auf dem jeder Stempel den Marker voranbringt), anneau (ein runder Balken um die nächste Prämie). Die Fotos der Prämien laden Sie in der App hoch, Seite Karte. Werte : tampons, medailles, vitrine, remplissage, chemin, anneau. - `forme_points` (enum, optional) : Modus points: das Aussehen der Karte. medailles (Standard): ein dicker Balken und eine große Medaille pro Prämie. vitrine: die Prämien nebeneinander, jede mit eigenem kleinen Balken. remplissage: die nächste Prämie in groß, die sich nach und nach einfärbt. chemin: ein Weg in S-Form, die Prämien als Etappen. anneau: ein runder Balken um die nächste Prämie, die Liste daneben. Die Fotos der Prämien laden Sie in der App hoch, Seite Karte. Werte : medailles, vitrine, remplissage, chemin, anneau. - `forme` (enum, optional) : Das Aussehen der Karte, in einem Wort (ersetzt forme_points und forme_paliers). Modi points und paliers: medailles (ein Balken und eine große Medaille pro Prämie), vitrine (die Prämien nebeneinander, jede mit eigenem Balken), remplissage (die nächste Prämie in groß, die sich einfärbt), chemin (ein Weg in S-Form, jeder Besuch bringt den Marker voran), anneau (ein runder Balken um die nächste Prämie). Modi tampons und paliers: die Anordnung der Stempel, grille (Standard), libre (verstreut), objets (große Objekte mit Schatten, ideal mit einem Foto), cercles. Bei paliers behält eine Anordnung die Stempel und setzt jede Prämie an die Stelle des Stempels ihrer Schwelle. Eine der fünf Formen ohne angegebenen Modus stellt die Karte auf den Modus paliers um. Werte : medailles, vitrine, remplissage, chemin, anneau, grille, libre, objets, cercles. - `encre` (string, optional) : Textfarbe der Karte, hexadezimal (Standard: so gewählt, dass sie auf dem Hintergrund lesbar bleibt). - `accent` (string, optional) : Akzentfarbe: gesetzte Stempel, Balken, Etiketten, hexadezimal (Standard: aus der Kollektion). - `logo_url` (string, ≤ 2000 Zeichen, optional) : Logo des Ladens, über seine https-Adresse (PNG, JPEG oder WebP, höchstens 5 MB): Sein Instagram-Profilbild reicht. Wenn möglich freigestellt, oben auf die Karte gesetzt; ohne Angabe von couleur, palette, encre oder accent übernimmt die Karte die Farben des Logos. - `panier_moyen` (number, 0.5…10000, optional) : Durchschnittliche Ausgabe eines Kunden, in Euro (dient den Schätzungen im Dashboard). - `langue` (enum, optional) : Sprache der zurückgegebenen Texte. Standard: die des Ladens. Werte : fr, en, es, de. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Mit `confirmer: false` die Zusammenfassung dessen, was angelegt wird. Mit `confirmer: true` wird der Laden angelegt und die Antwort enthält einen persönlichen Link: Darüber meldet sich die Person mit ihrer E-Mail an und findet ihre Karte, ihren QR-Code und ihren kostenlosen Testzeitraum. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Perfekt, schalte diese Karte für die Boulangerie Lemaire live. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "creer_commerce", "arguments": { "nom": "Boulangerie Lemaire", "metier": "boulangerie", "mode": "tampons", "tampons": 10, "recompense": "Das 10. Baguette gratis", "collection": "pass", "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"creer_commerce","arguments":{"nom":"Boulangerie Lemaire","metier":"boulangerie","mode":"tampons","tampons":10,"recompense":"Das 10. Baguette gratis","collection":"pass","confirmer":false}}}' ``` Source : https://stampywallet.com/de/docs/mcp/werkzeuge/creer_commerce/ --- # tableau_de_bord Mit Konto · Nur Lesen. Die Treue-Kennzahlen des Ladens für einen frei wählbaren Zeitraum: Besuche an der Kasse, gekommene Kunden, neue Kunden, Wiederkehrrate, verdiente und eingelöste Prämien, geschätzter Umsatz, mit einer Kurve pro Tag, Woche oder Monat und bei Bedarf dem Vergleich mit dem vorherigen, gleich langen Zeitraum. Verwenden für „Wie läuft es diesen Monat?“, „Wie viele Kunden im August?“, „Geht es aufwärts?“. Für die Kundenliste chercher_clients verwenden; um zu wissen, ob sich die Karte lohnt, rentabilite. ## Parameter - `periode` (enum, optional) : Untersuchter Zeitraum, in Tagen der Zeitzone des Ladens, heute eingeschlossen bei laufenden Zeiträumen (ce_mois = vom 1. bis heute). „personnalisee“ nutzt du/au. Standard derniers_30_jours. Werte : aujourdhui, hier, derniers_7_jours, derniers_30_jours, derniers_90_jours, derniers_12_mois, cette_semaine, semaine_derniere, ce_mois, mois_dernier, cette_annee, annee_derniere, depuis_le_debut, personnalisee. Standard : "derniers_30_jours". - `du` (string (date), optional) : Erster Tag, eingeschlossen (JJJJ-MM-TT). Es reicht, ihn anzugeben: Der Zeitraum wird zu „personnalisee“. - `au` (string (date), optional) : Letzter Tag, eingeschlossen (JJJJ-MM-TT). Standard: heute. - `comparer` (boolean, optional) : Fügt die Veränderung gegenüber dem gleich langen Zeitraum direkt davor hinzu (z. B. die 30 Tage vor den letzten 30 Tagen). Standard : true. - `indicateurs` (array, ≤ 9, optional) : Kennzahlen, die geliefert werden, in dieser Reihenfolge. Standard: alle. taux_retour = Anteil der Kunden im Zeitraum, die schon vorher da waren; chiffre_estime = Besuche × angegebener Durchschnittsbon (eine Schätzung, keine Kassenzahl). Werte : passages, clients_venus, nouveaux_clients, taux_retour, passages_par_client, recompenses_gagnees, recompenses_offertes, chiffre_estime, total_clients. - `courbe` (enum, optional) : Was die Kurve zeigt. Standard passages. Werte : passages, clients_venus, nouveaux_clients, recompenses_gagnees, recompenses_offertes, aucune. Standard : "passages". - `granularite` (enum, optional) : Schrittweite der Kurve. auto (Standard): Tag bis 2 Monate, Woche bis ca. 9 Monate, Monat darüber. Werte : auto, jour, semaine, mois. Standard : "auto". ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. ## Beispiel Prompt : « Wie läuft es diesen Monat im Vergleich zum letzten? » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "tableau_de_bord", "arguments": { "periode": "ce_mois", "comparer": true } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"tableau_de_bord","arguments":{"periode":"ce_mois","comparer":true}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/tableau_de_bord/ --- # rentabilite Mit Konto · Nur Lesen · Tarif Wachstum. Sagt, ob sich die Kundenkarte lohnt, für einen frei wählbaren Zeitraum: Anteil der Kunden, die wiederkommen, Wiederholungsbesuche und was sie in Euro ausmachen (Schätzung: Besuche × Durchschnittsbon), mittlerer Abstand zwischen zwei Besuchen, eingelöste Prämien und ihre Kosten, wenn angegeben, noch offene Prämien und das Ergebnis der automatischen Erinnerung. Durchschnittsbon und Kosten einer Prämie lassen sich anpassen, um neu zu rechnen. Verwenden für „Lohnt sich das?“, „Was bringt mir das?“, „Kommen meine Kunden wieder?“. Für die reinen Zahlen eines Zeitraums tableau_de_bord. ## Parameter - `periode` (enum, optional) : Untersuchter Zeitraum, in Tagen der Zeitzone des Ladens, heute eingeschlossen bei laufenden Zeiträumen (ce_mois = vom 1. bis heute). „personnalisee“ nutzt du/au. Standard derniers_90_jours. Werte : aujourdhui, hier, derniers_7_jours, derniers_30_jours, derniers_90_jours, derniers_12_mois, cette_semaine, semaine_derniere, ce_mois, mois_dernier, cette_annee, annee_derniere, depuis_le_debut, personnalisee. Standard : "derniers_90_jours". - `du` (string (date), optional) : Erster Tag, eingeschlossen (JJJJ-MM-TT). Es reicht, ihn anzugeben: Der Zeitraum wird zu „personnalisee“. - `au` (string (date), optional) : Letzter Tag, eingeschlossen (JJJJ-MM-TT). Standard: heute. - `panier_moyen` (number, 0.1…10000, optional) : Durchschnittsbon in Euro für diese Berechnung. Standard: der in den Einstellungen des Ladens angegebene. - `cout_recompense` (number, 0…10000, optional) : Was EINE Prämie den Ladeninhaber kostet (Selbstkosten), in Euro. Ohne diesen Wert werden die Kosten der Prämien nicht beziffert. - `comparer` (boolean, optional) : Fügt den gleich langen Zeitraum direkt davor hinzu, um zu sehen, ob es aufwärts geht. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. ## Beispiel Prompt : « Lohnt sich meine Stempelkarte? Eine Prämie kostet mich 1,20 €. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "rentabilite", "arguments": { "periode": "derniers_90_jours", "cout_recompense": 1.2 } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"rentabilite","arguments":{"periode":"derniers_90_jours","cout_recompense":1.2}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/rentabilite/ --- # meilleurs_moments Mit Konto · Nur Lesen · Tarif Wachstum. Zeigt, wann die Kunden kommen: durchschnittliche Besuche pro Wochentag, Verteilung nach Uhrzeit oder die vollsten Zeitfenster (Tag + Uhrzeit), für einen frei wählbaren Zeitraum und in der Ortszeit des Ladens. Kann auch die Anmeldungen neuer Kunden zählen. Verwenden für „Was ist mein bester Tag?“, „Wann ist bei mir am meisten los?“, „Wann starte ich ein Angebot, um eine Flaute zu füllen?“. ## Parameter - `par` (enum, optional) : jour_semaine (Standard): Durchschnitt pro Montag, Dienstag…; heure: Summe pro Tagesstunde; creneau: die meistbesuchten Kombinationen aus Tag + Uhrzeit. Werte : jour_semaine, heure, creneau. Standard : "jour_semaine". - `mesure` (enum, optional) : passages (Standard) oder nouveaux_clients (Anmeldungen zur Karte). Werte : passages, nouveaux_clients. Standard : "passages". - `jours` (array, ≤ 7, optional) : Für par=heure oder creneau: nur diese Wochentage behalten (z. B. ["samedi"]). Werte : lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche. - `periode` (enum, optional) : Untersuchter Zeitraum, in Tagen der Zeitzone des Ladens, heute eingeschlossen bei laufenden Zeiträumen (ce_mois = vom 1. bis heute). „personnalisee“ nutzt du/au. Standard derniers_90_jours. Werte : aujourdhui, hier, derniers_7_jours, derniers_30_jours, derniers_90_jours, derniers_12_mois, cette_semaine, semaine_derniere, ce_mois, mois_dernier, cette_annee, annee_derniere, depuis_le_debut, personnalisee. Standard : "derniers_90_jours". - `du` (string (date), optional) : Erster Tag, eingeschlossen (JJJJ-MM-TT). Es reicht, ihn anzugeben: Der Zeitraum wird zu „personnalisee“. - `au` (string (date), optional) : Letzter Tag, eingeschlossen (JJJJ-MM-TT). Standard: heute. - `limite` (integer, 1…50, optional) : Für par=creneau: Anzahl der gelieferten Zeitfenster (Standard 10). Standard : 10. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. ## Beispiel Prompt : « Um welche Uhrzeit ist samstags bei mir am meisten los? » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "meilleurs_moments", "arguments": { "par": "heure", "jours": [ "samedi" ] } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"meilleurs_moments","arguments":{"par":"heure","jours":["samedi"]}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/meilleurs_moments/ --- # chercher_clients Mit Konto · Nur Lesen. Listet die Kunden des Ladens nach einem Segment (Stammkunden, Weggebliebene, ein Stempel vor der Prämie, Prämie einzulösen, Neue, Inaktive, nie wiedergekommen), kombiniert mit Filtern: Vorname, Stempel auf der Karte, Anzahl Besuche, Anmeldedatum, Datum des letzten Besuchs, Art des Wallets; sortiert und seitenweise. Liefert für jeden eine Kennung, den Vornamen und den Anfangsbuchstaben des Nachnamens, die Besuche, den letzten Besuch und den Stand der Karte, nie E-Mail oder Telefon. Verwenden für „Wer sind meine besten Kunden?“, „Wer ist nicht wiedergekommen?“, „Wer ist kurz vor seiner Prämie?“ oder um die Kennung eines Kunden vor fiche_client zu finden. ## Parameter - `segment` (enum, optional) : Ausgangsgruppe, so definiert wie in der App. tous (Standard); habitues = mindestens 4 Besuche in den letzten 60 Tagen; perdus = mindestens 4 Mal gekommen und länger weg als das Anderthalbfache ihres üblichen Rhythmus (Median der Abstände zwischen ihren Besuchen) oder, ohne genug Verlauf, länger als die Frist des Ladens; Urlaub und Ruhetage zählen nicht; presque = ihnen fehlt nur ein Stempel bis zur Prämie; recompense_prete = eine verdiente Prämie, noch nicht eingelöst, nicht abgelaufen; nouveaux = in den letzten 30 Tagen angemeldet; inactifs = kein Besuch seit mehr als der Frist des Ladens, in Kalendertagen, egal wie oft sie da waren; un_seul_passage = höchstens ein Besuch: angemeldet, aber nie wiedergekommen. Werte : tous, habitues, perdus, presque, recompense_prete, nouveaux, inactifs, un_seul_passage. Standard : "tous". - `recherche` (string, ≤ 60 Zeichen, optional) : Teil des Vor- oder Nachnamens (Akzente und Groß-/Kleinschreibung werden ignoriert). - `tampons_min` (integer, ≥ 0, optional) : Mindestens so viele Stempel auf der aktuellen Karte. - `tampons_max` (integer, ≥ 0, optional) : Höchstens so viele Stempel auf der aktuellen Karte. - `visites_min` (integer, ≥ 0, optional) : Mindestens so viele Besuche seit der Anmeldung (Willkommensstempel nicht mitgezählt). - `visites_max` (integer, ≥ 0, optional) : Höchstens so viele Besuche seit der Anmeldung. - `inactif_depuis_jours` (integer, 1…3650, optional) : Kein Besuch seit mindestens N Kalendertagen (ein Kunde, der nie da war, zählt ab seiner Anmeldung). - `actif_depuis_jours` (integer, 1…3650, optional) : Mindestens ein Besuch in den letzten N Tagen. - `inscrit_depuis` (string (date), optional) : An diesem Tag oder danach angemeldet (JJJJ-MM-TT). - `inscrit_avant` (string (date), optional) : An diesem Tag oder davor angemeldet (JJJJ-MM-TT). - `derniere_visite_depuis` (string (date), optional) : Letzter Besuch an diesem Tag oder danach (JJJJ-MM-TT). - `derniere_visite_avant` (string (date), optional) : Letzter Besuch an diesem Tag oder davor (JJJJ-MM-TT). Schließt Kunden aus, die nie da waren. - `wallet` (enum, optional) : Wo der Kunde seine Karte aufbewahrt. aucun = Webseite, ohne Wallet. Werte : tous, apple, google, aucun. Standard : "tous". - `tri` (enum, optional) : Reihenfolge der Ergebnisse. Standard derniere_visite (die jüngsten zuerst). Werte : derniere_visite, visites, visites_90j, tampons, recompenses, inscription, prenom. Standard : "derniere_visite". - `ordre` (enum, optional) : auto (Standard): absteigend, außer prenom (A→Z). Werte : auto, asc, desc. Standard : "auto". - `limite` (integer, 1…100, optional) : Maximale Anzahl an Ergebnissen. Standard : 25. - `decalage` (integer, ≥ 0, optional) : Anzahl der zu überspringenden Ergebnisse (Paginierung). Standard : 0. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. ## Beispiel Prompt : « Welche meiner Stammkunden kommen nicht mehr? » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "chercher_clients", "arguments": { "segment": "perdus", "tri": "visites", "limite": 20 } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"chercher_clients","arguments":{"segment":"perdus","tri":"visites","limite":20}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/chercher_clients/ --- # fiche_client Mit Konto · Nur Lesen. Der Verlauf EINES Kunden: Anmeldedatum, genutztes Wallet, Anzahl der Besuche und Besuchsrhythmus, Besuche Monat für Monat, aktuelle Karte, verdiente, eingelöste und offene Prämien, letzte Besuche mit Datum. Zu finden über seine Kennung (von chercher_clients) oder über seinen Vornamen, eventuell gefolgt vom Anfangsbuchstaben des Nachnamens („Maëlle P.“); passen mehrere Kunden, wird die Liste der Kandidaten zur Auswahl geliefert. Verwenden für „Wann war Zoé zuletzt da?“, „Wie oft war Louis schon da?“. Gibt weder E-Mail noch Telefon heraus. ## Parameter - `id` (string, optional) : Kennung des Kunden (UUID), wie von chercher_clients geliefert. Hat Vorrang vor prenom. - `prenom` (string, ≤ 60 Zeichen, optional) : Vorname des Kunden, eventuell gefolgt vom Anfangsbuchstaben oder dem Nachnamen („Maëlle P.“). Akzente und Groß-/Kleinschreibung werden ignoriert. - `historique_limite` (integer, 0…200, optional) : Anzahl der letzten Besuche, die im Detail gezeigt werden (Standard 15). Standard : 15. - `inclure_offerts` (boolean, optional) : true: Der Verlauf zeigt auch die geschenkten Stempel (Willkommen, Bewertung), als solche gekennzeichnet. Standard false: nur echte Besuche. Standard : false. - `mois` (integer, 1…36, optional) : Anzahl der Monate in der Besuchskurve (Standard 12). Standard : 12. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. ## Beispiel Prompt : « Wann war Zoé zum letzten Mal da? » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "fiche_client", "arguments": { "prenom": "Zoé" } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fiche_client","arguments":{"prenom":"Zoé"}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/fiche_client/ --- # envoyer_message Mit Konto · Schreibt (bestätigen). Schickt eine Benachrichtigung auf den Sperrbildschirm der Kunden (über ihre Karte in Apple Wallet oder Google Wallet). Verwenden, um eine Neuheit, ein Angebot oder ein Event anzukündigen oder Kunden zurückzuholen. Die Zielgruppe ist einstellbar (alle, Stammkunden, Weggebliebene, kurz vor der Prämie, Neue, Prämie abzuholen, Inaktive) und lässt sich mit Filtern kombinieren (Tage ohne Besuch, Stempel auf der Karte, Besuche, Anmeldedatum). Text mit höchstens 180 Zeichen, wird unverändert verschickt. Eine Nachricht pro Tag und Laden. MIT client_id (von chercher_clients): eine Nachricht nur an DIESEN Kunden, zum Beispiel „Ihre Bestellung ist fertig“ (Reinigung, Schuhmacher, Feinkost, Blumenladen): eine fertige Vorlage (modele = pret, retrait, recu, attente) oder texte + modele=libre; optional auch aussi_sms und aussi_email. Sie zählt nicht zur Tagesnachricht an alle; höchstens zwei pro Kunde und Tag. Zuerst mit confirmer=false aufrufen: Die Vorschau zeigt den genauen Text, die Anzahl der Empfänger und wie viele sie wirklich erhalten können, ohne etwas zu verschicken. Erst nach ausdrücklicher Zustimmung der Person mit confirmer=true aufrufen: Eine verschickte Nachricht lässt sich nicht zurückholen. Für automatische Nachrichten (Erinnerung, Geburtstag, Hinweise) regler_automatismes verwenden. ## Parameter - `texte` (string, ≤ 180 Zeichen, optional) : Der genaue Text der Benachrichtigung, höchstens 180 Zeichen. Auf dem Telefon steht der Name des Ladens davor: Sie müssen ihn nicht wiederholen. Pflicht ohne client_id; mit client_id nur für modele=libre. - `audience` (enum, optional) : Wer die Nachricht bekommt. tous = alle Kunden; habitues = 4 Besuche oder mehr in 60 Tagen; perdus = Stammkunden, deren Abwesenheit das Anderthalbfache ihres üblichen Rhythmus überschreitet, oder ohne genug Verlauf die Frist des Ladens (die Definition aus der Ansicht Kunden); presque = nur noch ein Stempel bis zur Prämie; nouveaux = seit 30 Tagen angemeldet (oder seit inscrit_depuis); recompense_prete = eine verdiente Prämie, noch nicht abgeholt; inactifs = jeder Kunde ohne Besuch seit inactif_depuis_jours Öffnungstagen (standardmäßig die Frist des Ladens), Stammkunde oder nicht. Jede Zielgruppe außer tous und jeder Filter erfordert die Funktion „gezielte Benachrichtigungen“. Werte : tous, habitues, perdus, presque, nouveaux, recompense_prete, inactifs. Standard : "tous". - `inactif_depuis_jours` (integer, 1…730, optional) : Filter: kein Besuch seit mindestens N ÖFFNUNGStagen (Ruhetage und Urlaub zählen nicht). - `actif_depuis_jours` (integer, 1…730, optional) : Filter: mindestens ein Besuch in den letzten N Öffnungstagen. - `tampons_min` (integer, 0…500, optional) : Filter: mindestens N Stempel auf der aktuellen Karte. - `tampons_max` (integer, 0…500, optional) : Filter: höchstens N Stempel auf der aktuellen Karte. - `passages_min` (integer, 1…10000, optional) : Filter: insgesamt mindestens N Besuche seit der Anmeldung. - `inscrit_depuis` (string (date), optional) : Filter: an diesem Tag oder danach angemeldet (JJJJ-MM-TT). - `inscrit_avant` (string (date), optional) : Filter: vor diesem Tag angemeldet (JJJJ-MM-TT, ausgeschlossen). - `client_id` (string, optional) : Kennung (UUID) EINES Kunden, geliefert von chercher_clients oder fiche_client: Die Nachricht geht nur an ihn. Schließt audience und Filter aus. - `modele` (enum, optional) : Mit client_id: pret = „Ihre Bestellung ist fertig…“, retrait = „Ihr Artikel liegt zur Abholung bereit…“, recu = „Wir haben Ihre Bestellung erhalten…“, attente = „Ihre Bestellung wartet noch auf Sie…“, libre = der angegebene Text. Standard: libre, wenn ein Text angegeben ist. Werte : pret, retrait, recu, attente, libre. - `langue` (enum, optional) : Mit client_id und einer Vorlage: die Sprache des fertigen Textes. Standard: die des Ladens. Werte : fr, en, es, de. - `aussi_sms` (boolean, optional) : Mit client_id: auch per SMS (Tarif Wachstum, Monatsbudget, zwischen 8 und 20 Uhr, sonst zur Öffnung). Standard false. Standard : false. - `aussi_email` (boolean, optional) : Mit client_id: auch per E-Mail, wenn der Kunde eine hinterlassen hat. Standard false. Standard : false. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Sag meinen Kunden, die kurz vor der Prämie stehen, dass es dieses Wochenende Mandelcroissants gibt. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "envoyer_message", "arguments": { "texte": "Mandelcroissants dieses Wochenende: nur noch ein Stempel bis zu Ihrer Prämie!", "audience": "presque", "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"envoyer_message","arguments":{"texte":"Mandelcroissants dieses Wochenende: nur noch ein Stempel bis zu Ihrer Prämie!","audience":"presque","confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/envoyer_message/ --- # lister_messages_recurrents Mit Konto · Nur Lesen · Tarif Wachstum. Listet die wiederkehrenden Nachrichten des Ladens (aktiv und pausiert), mit ihrer id, ihrem Rhythmus, der Zielgruppe und dem nächsten Versand. Ändert nichts. ## Parameter Keine Parameter. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. ## Beispiel Prompt : « Welche wiederkehrenden Nachrichten habe ich geplant? » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "lister_messages_recurrents", "arguments": {} } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"lister_messages_recurrents","arguments":{}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/lister_messages_recurrents/ --- # programmer_message_recurrent Mit Konto · Schreibt (bestätigen) · Tarif Wachstum. Plant eine Nachricht, die sich von selbst auf dem Sperrbildschirm der Kunden wiederholt: jede Woche (an einem oder mehreren Tagen) oder jeden Monat (an einem bestimmten Tag im Monat, oder „am ersten Montag“, „am letzten Freitag“), zu einer Uhrzeit des Ladens zwischen 7 und 21:45 Uhr. Beispiele: „jeden Dienstag um 11 Uhr der Standort des Foodtrucks“, „am 1. jedes Monats an die Geburtstagskinder des Monats“. Die Zielgruppe wird bei jedem Versand neu berechnet. Ende optional: ein Datum oder eine Anzahl von Sendungen. Regeln: eine Nachricht pro Tag (an einem Tag, an dem schon eine andere Nachricht rausgeht, wird der Termin übersprungen), Ruhetage und Urlaub werden übersprungen (oder mit si_ferme=decaler auf den nächsten Öffnungstag verschoben), Ruhezeiten werden eingehalten, erster Versand innerhalb von 60 Tagen. confirmer=false (Standard) liefert eine Vorschau; confirmer=true führt aus, nach ausdrücklicher Zustimmung der Person. Für einen einmaligen, sofortigen Versand envoyer_message verwenden. ## Parameter - `texte` (string, ≤ 180 Zeichen, Pflicht) : Der genaue Text der Benachrichtigung, höchstens 180 Zeichen. - `groupe` (enum, optional) : Wer sie bekommt, bei jedem Versand neu berechnet: tous, inactifs_30/60/90 (seit N Tagen nicht da), proches (1 oder 2 Stempel vor der Prämie), anniversaires (in diesem Monat geboren), meilleurs, nouveaux. Jede Gruppe außer tous erfordert gezielte Benachrichtigungen. Nur beim Planen (Standard tous). Werte : tous, inactifs_30, inactifs_60, inactifs_90, proches, anniversaires, meilleurs, nouveaux. - `frequence` (enum, optional) : semaine: mit jours. mois: mit jour_mois, oder rang und jour_rang. Werte : semaine, mois. - `jours` (array, ≤ 7, optional) : Für frequence=semaine: die Versandtage. Werte : dimanche, lundi, mardi, mercredi, jeudi, vendredi, samedi. - `jour_mois` (integer, 1…31, optional) : Für frequence=mois: der Tag im Monat (1 bis 31; ein 31. fällt in kürzeren Monaten auf den letzten Tag). - `rang` (enum, optional) : Für frequence=mois: „premier“ Montag, …, „dernier“ Freitag im Monat (mit jour_rang). Werte : premier, deuxieme, troisieme, quatrieme, dernier. - `jour_rang` (enum, optional) : Der Wochentag, der zu rang gehört. Werte : dimanche, lundi, mardi, mercredi, jeudi, vendredi, samedi. - `heure` (string, optional) : Die Uhrzeit des Ladens, HH:MM, zwischen 07:00 und 21:45. - `debut` (string (date), optional) : Erster möglicher Tag (JJJJ-MM-TT). Standard: heute. - `fin` (string (date), optional) : Letzter möglicher Tag, eingeschlossen (JJJJ-MM-TT). Optional. - `nombre` (integer, 1…366, optional) : Oder: die Anzahl tatsächlich verschickter Nachrichten, nach der die Regel endet. - `si_ferme` (enum, optional) : An einem Ruhetag oder im Urlaub: sauter (Standard, überspringen) oder decaler (auf den nächsten Öffnungstag verschieben). Werte : sauter, decaler. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Sag meinen Kunden jeden Dienstag um 11 Uhr, wo der Foodtruck steht. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "programmer_message_recurrent", "arguments": { "texte": "Foodtruck heute am Rathausplatz, von 11:30 bis 14 Uhr. Bis gleich!", "groupe": "tous", "frequence": "semaine", "jours": [ "mardi" ], "heure": "11:00", "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"programmer_message_recurrent","arguments":{"texte":"Foodtruck heute am Rathausplatz, von 11:30 bis 14 Uhr. Bis gleich!","groupe":"tous","frequence":"semaine","jours":["mardi"],"heure":"11:00","confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/programmer_message_recurrent/ --- # modifier_message_recurrent Mit Konto · Schreibt (bestätigen) · Tarif Wachstum. Ändert den Text oder den Rhythmus einer wiederkehrenden Nachricht (id von lister_messages_recurrents). Nur die angegebenen Felder ändern sich; sans_fin=true entfernt das Ende. Regeln: eine Nachricht pro Tag (an einem Tag, an dem schon eine andere Nachricht rausgeht, wird der Termin übersprungen), Ruhetage und Urlaub werden übersprungen (oder mit si_ferme=decaler auf den nächsten Öffnungstag verschoben), Ruhezeiten werden eingehalten, erster Versand innerhalb von 60 Tagen. confirmer=false (Standard) liefert eine Vorschau; confirmer=true führt aus, nach ausdrücklicher Zustimmung der Person. ## Parameter - `id` (integer, ≥ 1, Pflicht) : Die betroffene Regel, geliefert von lister_messages_recurrents. - `texte` (string, ≤ 180 Zeichen, optional) : Der genaue Text der Benachrichtigung, höchstens 180 Zeichen. - `frequence` (enum, optional) : semaine: mit jours. mois: mit jour_mois, oder rang und jour_rang. Werte : semaine, mois. - `jours` (array, ≤ 7, optional) : Für frequence=semaine: die Versandtage. Werte : dimanche, lundi, mardi, mercredi, jeudi, vendredi, samedi. - `jour_mois` (integer, 1…31, optional) : Für frequence=mois: der Tag im Monat (1 bis 31; ein 31. fällt in kürzeren Monaten auf den letzten Tag). - `rang` (enum, optional) : Für frequence=mois: „premier“ Montag, …, „dernier“ Freitag im Monat (mit jour_rang). Werte : premier, deuxieme, troisieme, quatrieme, dernier. - `jour_rang` (enum, optional) : Der Wochentag, der zu rang gehört. Werte : dimanche, lundi, mardi, mercredi, jeudi, vendredi, samedi. - `heure` (string, optional) : Die Uhrzeit des Ladens, HH:MM, zwischen 07:00 und 21:45. - `debut` (string (date), optional) : Erster möglicher Tag (JJJJ-MM-TT). Standard: heute. - `fin` (string (date), optional) : Letzter möglicher Tag, eingeschlossen (JJJJ-MM-TT). Optional. - `nombre` (integer, 1…366, optional) : Oder: die Anzahl tatsächlich verschickter Nachrichten, nach der die Regel endet. - `si_ferme` (enum, optional) : An einem Ruhetag oder im Urlaub: sauter (Standard, überspringen) oder decaler (auf den nächsten Öffnungstag verschieben). Werte : sauter, decaler. - `sans_fin` (boolean, optional) : Beim Ändern: das Enddatum oder die Anzahl der Sendungen entfernen. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Verleg meine Foodtruck-Nachricht auf Mittwoch, 11:30 Uhr. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "modifier_message_recurrent", "arguments": { "id": 7, "jours": [ "mercredi" ], "heure": "11:30", "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"modifier_message_recurrent","arguments":{"id":7,"jours":["mercredi"],"heure":"11:30","confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/modifier_message_recurrent/ --- # suspendre_message_recurrent Mit Konto · Schreibt (bestätigen) · Tarif Wachstum. Pausiert eine aktive wiederkehrende Nachricht: Es geht nichts mehr raus bis reprendre_message_recurrent. confirmer=false (Standard) liefert eine Vorschau; confirmer=true führt aus, nach ausdrücklicher Zustimmung der Person. ## Parameter - `id` (integer, ≥ 1, Pflicht) : Die betroffene Regel, geliefert von lister_messages_recurrents. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Pausiere meine Wochennachricht während meines Urlaubs. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "suspendre_message_recurrent", "arguments": { "id": 7, "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"suspendre_message_recurrent","arguments":{"id":7,"confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/suspendre_message_recurrent/ --- # reprendre_message_recurrent Mit Konto · Schreibt (bestätigen) · Tarif Wachstum. Nimmt eine pausierte wiederkehrende Nachricht ab heute wieder auf, ohne die Tage der Pause nachzuholen. confirmer=false (Standard) liefert eine Vorschau; confirmer=true führt aus, nach ausdrücklicher Zustimmung der Person. ## Parameter - `id` (integer, ≥ 1, Pflicht) : Die betroffene Regel, geliefert von lister_messages_recurrents. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Starte meine wöchentliche Foodtruck-Nachricht wieder. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "reprendre_message_recurrent", "arguments": { "id": 7, "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reprendre_message_recurrent","arguments":{"id":7,"confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/reprendre_message_recurrent/ --- # arreter_message_recurrent Mit Konto · Schreibt (bestätigen) · Tarif Wachstum. Beendet und löscht eine wiederkehrende Nachricht; was schon verschickt wurde, bleibt im Verlauf. confirmer=false (Standard) liefert eine Vorschau; confirmer=true führt aus, nach ausdrücklicher Zustimmung der Person. ## Parameter - `id` (integer, ≥ 1, Pflicht) : Die betroffene Regel, geliefert von lister_messages_recurrents. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Beende endgültig meine monatliche Geburtstagsnachricht. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "arreter_message_recurrent", "arguments": { "id": 7, "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"arreter_message_recurrent","arguments":{"id":7,"confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/arreter_message_recurrent/ --- # historique_messages Mit Konto · Nur Lesen. Listet die bereits an die Kunden verschickten Nachrichten, von der neuesten zur ältesten, mit ihrer Zustellbilanz: empfangen, Kunden ohne Bildschirm (nicht erreichbar), fehlgeschlagen und noch im Versand. Fasst außerdem die automatischen Nachrichten des Zeitraums zusammen (Erinnerungen an Weggebliebene, Geburtstage) und sagt, ob heute noch eine Nachricht rausgehen kann. Verwenden, um zu wissen, was verschickt wurde, um zu prüfen, ob ein Versand angekommen ist, oder bevor Sie eine neue schreiben. ## Parameter - `limite` (integer, 1…50, optional) : Maximale Anzahl an Ergebnissen. Standard : 10. - `decalage` (integer, ≥ 0, optional) : Anzahl der zu überspringenden Ergebnisse (Paginierung). Standard : 0. - `depuis` (string (date), optional) : Nur Sendungen ab diesem Tag (JJJJ-MM-TT). Dient auch als Beginn des Zeitraums für die Zusammenfassung der automatischen Nachrichten (standardmäßig die letzten 30 Tage). - `jusqu_au` (string (date), optional) : Nur Sendungen bis zu diesem Tag einschließlich (JJJJ-MM-TT). ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. ## Beispiel Prompt : « Was habe ich diesen Monat an meine Kunden geschickt, und ist es angekommen? » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "historique_messages", "arguments": { "depuis": "2026-10-01" } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"historique_messages","arguments":{"depuis":"2026-10-01"}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/historique_messages/ --- # regler_automatismes Mit Konto · Schreibt (bestätigen). Liest und stellt die Nachrichten ein, die StampyWallet von selbst an die Kunden schickt: die Erinnerung an Stammkunden, die nicht mehr kommen (wenn ihre Abwesenheit das Anderthalbfache ihres üblichen Rhythmus überschreitet oder, ohne genug Verlauf, die Frist des Ladens, die je nach Branche vorgeschlagen wird und einstellbar ist), die Geburtstagsnachricht, die Hinweise „nur noch ein Stempel“ und „Prämie bereit“ (und ihre Verzögerung), die Ruhezeiten, in denen nichts rausgeht; zeigt außerdem den Montagsbericht, der an den Ladeninhaber geht. Ohne Änderungsparameter: liefert den aktuellen Stand, Texte eingeschlossen. Mit Änderungen: confirmer=false liefert eine Vorschau vorher → nachher, ohne etwas zu ändern, confirmer=true speichert. Nur die angegebenen Felder ändern sich. Für eine einmalige Nachricht envoyer_message verwenden. ## Parameter - `relance_active` (boolean, optional) : Schaltet die automatische Erinnerung an weggebliebene Kunden ein oder aus (eine pro Kunde und Abwesenheit). - `delai_relance_jours` (integer, optional) : Frist des Ladens, bis ein Stammkunde als „weggeblieben“ gilt, in Kalendertagen: einer der Werte 14, 21, 28, 35, 42, 60, 90. Sie gilt für Kunden ohne genug Verlauf und begrenzt den Rhythmus der anderen (von der Hälfte bis zum Doppelten). Um zur für die Branche vorgeschlagenen Frist zurückzukehren, "delai_relance" in effacer angeben. - `texte_relance` (string, ≤ 180 Zeichen, optional) : Text der Erinnerung, höchstens 180 Zeichen. Um zum Standardtext zurückzukehren, "texte_relance" in effacer angeben. - `anniversaire_active` (boolean, optional) : Schaltet die Geburtstagsnachricht ein oder aus (sie geht nur raus, wenn ein Text existiert und die Karte nach dem Geburtstag fragt). - `cadeau_anniversaire` (enum, optional) : Das Geburtstagsgeschenk, 30 Tage ab dem Geburtstag gültig: message (nur der Text), pourcent (ein Rabatt auf jeden Einkauf), un_offert („1 gekauft, 1 gratis“, einmal), choix (der Kunde wählt an der Theke zwischen dem Rabatt und „1 gekauft, 1 gratis“). Bereits vergebene Geschenke ändern sich nicht. Werte : message, pourcent, un_offert, choix. - `pourcent_anniversaire` (integer, 1…90, optional) : Der Prozentsatz des Geburtstagsrabatts (pourcent und choix), von 1 bis 90. - `texte_anniversaire` (string, ≤ 180 Zeichen, optional) : Text der Geburtstagsnachricht, höchstens 180 Zeichen, am besten mit dem Geschenk. Ohne Text geht nichts raus. - `rappel_presque` (boolean, optional) : Erinnerung „nur noch ein Stempel“, wenn nur noch ein Besuch fehlt. - `rappel_recompense` (boolean, optional) : Erinnerung „Ihre Prämie wartet auf Sie“, sobald sie verdient ist. - `delai_rappel_minutes` (integer, optional) : Abstand zwischen Besuch und Erinnerung, in Minuten: einer der Werte 0, 30, 60, 180, 1440 (1440 = am nächsten Tag). - `heures_calmes_debut` (integer, 0…23, optional) : Beginn der Ruhezeit (Stunde von 0 bis 23): danach kommt keine automatische Benachrichtigung mehr an. - `heures_calmes_fin` (integer, 0…23, optional) : Ende der Ruhezeit (Stunde von 0 bis 23): ab dieser Stunde wird wieder verschickt. - `canal_avis` (enum, optional) : Kanal für „Bewertungsanfrage“: auto (empfohlen: Eine wichtige Nachricht geht zuerst per SMS raus, außer an Kunden, die auf Benachrichtigungen reagieren; eine kleine als Benachrichtigung und per SMS nur an Kunden, die besser auf SMS reagieren), notif, secours (SMS, wenn die Benachrichtigung nicht ankommt), sms (zuerst SMS), email (E-Mail, wenn die Benachrichtigung nicht ankommt). Werte : auto, notif, secours, sms, email. - `importance_avis` (enum, optional) : Wichtigkeit von „Bewertungsanfrage“: importante (hat beim SMS-Budget Vorrang) oder petite. Werte : importante, petite. - `canal_anniversaire` (enum, optional) : Kanal für „Geburtstag“: auto (empfohlen: Eine wichtige Nachricht geht zuerst per SMS raus, außer an Kunden, die auf Benachrichtigungen reagieren; eine kleine als Benachrichtigung und per SMS nur an Kunden, die besser auf SMS reagieren), notif, secours (SMS, wenn die Benachrichtigung nicht ankommt), sms (zuerst SMS), email (E-Mail, wenn die Benachrichtigung nicht ankommt). Werte : auto, notif, secours, sms, email. - `importance_anniversaire` (enum, optional) : Wichtigkeit von „Geburtstag“: importante (hat beim SMS-Budget Vorrang) oder petite. Werte : importante, petite. - `canal_rappels` (enum, optional) : Kanal für „Erinnerungen“: auto (empfohlen: Eine wichtige Nachricht geht zuerst per SMS raus, außer an Kunden, die auf Benachrichtigungen reagieren; eine kleine als Benachrichtigung und per SMS nur an Kunden, die besser auf SMS reagieren), notif, secours (SMS, wenn die Benachrichtigung nicht ankommt), sms (zuerst SMS). Werte : auto, notif, secours, sms. - `importance_rappels` (enum, optional) : Wichtigkeit von „Erinnerungen“: importante (hat beim SMS-Budget Vorrang) oder petite. Werte : importante, petite. - `canal_relance` (enum, optional) : Kanal für „Rückholnachricht“: auto (empfohlen: Eine wichtige Nachricht geht zuerst per SMS raus, außer an Kunden, die auf Benachrichtigungen reagieren; eine kleine als Benachrichtigung und per SMS nur an Kunden, die besser auf SMS reagieren), notif, secours (SMS, wenn die Benachrichtigung nicht ankommt), sms (zuerst SMS). Werte : auto, notif, secours, sms. - `importance_relance` (enum, optional) : Wichtigkeit von „Rückholnachricht“: importante (hat beim SMS-Budget Vorrang) oder petite. Werte : importante, petite. - `canal_messages` (enum, optional) : Kanal für „Nachrichten des Ladeninhabers“: auto (empfohlen: Eine wichtige Nachricht geht zuerst per SMS raus, außer an Kunden, die auf Benachrichtigungen reagieren; eine kleine als Benachrichtigung und per SMS nur an Kunden, die besser auf SMS reagieren), notif, secours (SMS, wenn die Benachrichtigung nicht ankommt), sms (zuerst SMS). Werte : auto, notif, secours, sms. - `importance_messages` (enum, optional) : Wichtigkeit von „Nachrichten des Ladeninhabers“: importante (hat beim SMS-Budget Vorrang) oder petite. Werte : importante, petite. - `reserve_sms` (integer, 0…100, optional) : Anteil des monatlichen SMS-Budgets, der für wichtige Nachrichten reserviert bleibt, in %: 0, 25, 50, 75, 100. - `effacer` (array, optional) : Texte, die gelöscht werden. texte_relance kehrt zum Standardtext zurück; ein leerer texte_anniversaire stoppt faktisch die Geburtstagsnachrichten; delai_relance kehrt zur für die Branche vorgeschlagenen Frist zurück. Werte : texte_relance, texte_anniversaire, delai_relance. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Schalte die Geburtstagsnachricht mit 10 % Rabatt ein. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "regler_automatismes", "arguments": { "anniversaire_active": true, "cadeau_anniversaire": "pourcent", "pourcent_anniversaire": 10, "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"regler_automatismes","arguments":{"anniversaire_active":true,"cadeau_anniversaire":"pourcent","pourcent_anniversaire":10,"confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/regler_automatismes/ --- # lister_fermetures Mit Konto · Nur Lesen. Listet den Urlaub des Ladens (anstehend und aus den letzten zwei Monaten, mit ihrer id) und die wöchentlichen Ruhetage. Ändert nichts. Ruhetage zählen nicht zur Abwesenheit eines Kunden: Richtig eingetragener Urlaub verhindert, dass Stammkunden als „weggeblieben“ gelten und nach Ihrer Rückkehr eine Erinnerung bekommen. ## Parameter Keine Parameter. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. ## Beispiel Prompt : « An welchen Tagen habe ich in den nächsten Wochen geschlossen? » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "lister_fermetures", "arguments": {} } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"lister_fermetures","arguments":{}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/lister_fermetures/ --- # ajouter_conges Mit Konto · Schreibt (bestätigen). Fügt einen Schließzeitraum hinzu (Urlaub, Feiertag), vom ersten bis zum letzten Tag einschließlich. Ruhetage zählen nicht zur Abwesenheit eines Kunden: Richtig eingetragener Urlaub verhindert, dass Stammkunden als „weggeblieben“ gelten und nach Ihrer Rückkehr eine Erinnerung bekommen. Optional bereitet prevenir_clients=true mit einem texte zusätzlich eine Benachrichtigung an alle Kunden vor (gleiche Regeln wie envoyer_message: eine Nachricht pro Tag). confirmer=false (Standard) liefert eine Vorschau; confirmer=true speichert (und verschickt die Nachricht, falls gewünscht), nach ausdrücklicher Zustimmung der Person. ## Parameter - `du` (string (date), Pflicht) : Erster geschlossener Tag (JJJJ-MM-TT). - `au` (string (date), optional) : Letzter geschlossener Tag, eingeschlossen (JJJJ-MM-TT). Standard: derselbe Tag wie du. - `libelle` (string, ≤ 80 Zeichen, optional) : Name des Zeitraums, zur Orientierung („Sommerurlaub“). - `prevenir_clients` (boolean, optional) : true: schickt außerdem eine Benachrichtigung mit texte an alle Kunden. Zählt als Nachricht des Tages. Standard : false. - `texte` (string, ≤ 180 Zeichen, optional) : Text der Benachrichtigung an die Kunden (höchstens 180 Zeichen), wenn prevenir_clients=true. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Ich habe vom 24. bis 31. Dezember geschlossen, sag meinen Kunden Bescheid. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "ajouter_conges", "arguments": { "du": "2026-12-24", "au": "2026-12-31", "libelle": "Feiertage zum Jahresende", "prevenir_clients": true, "texte": "Wir haben vom 24. bis 31. Dezember geschlossen. Schöne Feiertage und bis bald!", "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ajouter_conges","arguments":{"du":"2026-12-24","au":"2026-12-31","libelle":"Feiertage zum Jahresende","prevenir_clients":true,"texte":"Wir haben vom 24. bis 31. Dezember geschlossen. Schöne Feiertage und bis bald!","confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/ajouter_conges/ --- # supprimer_conges Mit Konto · Schreibt (bestätigen). Löscht einen Schließzeitraum über seine id (von lister_fermetures). Optional bereitet prevenir_clients=true mit einem texte zusätzlich eine Benachrichtigung an alle Kunden vor (gleiche Regeln wie envoyer_message: eine Nachricht pro Tag). confirmer=false (Standard) liefert eine Vorschau; confirmer=true speichert (und verschickt die Nachricht, falls gewünscht), nach ausdrücklicher Zustimmung der Person. ## Parameter - `id` (string, Pflicht) : Kennung des zu löschenden Zeitraums (geliefert von lister_fermetures). - `prevenir_clients` (boolean, optional) : true: schickt außerdem eine Benachrichtigung mit texte an alle Kunden. Zählt als Nachricht des Tages. Standard : false. - `texte` (string, ≤ 180 Zeichen, optional) : Text der Benachrichtigung an die Kunden (höchstens 180 Zeichen), wenn prevenir_clients=true. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Streich meinen Urlaub im August, ich habe doch geöffnet. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "supprimer_conges", "arguments": { "id": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f9a4c13", "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"supprimer_conges","arguments":{"id":"3f6c2a1e-8b4d-4c7a-9e21-5d0b7f9a4c13","confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/supprimer_conges/ --- # regler_jours_fermes Mit Konto · Schreibt (bestätigen). Ersetzt die wöchentlichen Ruhetage (zum Beispiel sonntags und montags geschlossen). Ruhetage zählen nicht zur Abwesenheit eines Kunden: Richtig eingetragener Urlaub verhindert, dass Stammkunden als „weggeblieben“ gelten und nach Ihrer Rückkehr eine Erinnerung bekommen. Optional bereitet prevenir_clients=true mit einem texte zusätzlich eine Benachrichtigung an alle Kunden vor (gleiche Regeln wie envoyer_message: eine Nachricht pro Tag). confirmer=false (Standard) liefert eine Vorschau; confirmer=true speichert (und verschickt die Nachricht, falls gewünscht), nach ausdrücklicher Zustimmung der Person. ## Parameter - `jours_fermes` (array, ≤ 7, Pflicht) : Die VOLLSTÄNDIGE Liste der wöchentlichen Ruhetage (leere Liste = jeden Tag geöffnet). Werte : dimanche, lundi, mardi, mercredi, jeudi, vendredi, samedi. - `prevenir_clients` (boolean, optional) : true: schickt außerdem eine Benachrichtigung mit texte an alle Kunden. Zählt als Nachricht des Tages. Standard : false. - `texte` (string, ≤ 180 Zeichen, optional) : Text der Benachrichtigung an die Kunden (höchstens 180 Zeichen), wenn prevenir_clients=true. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Ab jetzt habe ich sonntags und montags geschlossen. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "regler_jours_fermes", "arguments": { "jours_fermes": [ "dimanche", "lundi" ], "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"regler_jours_fermes","arguments":{"jours_fermes":["dimanche","lundi"],"confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/regler_jours_fermes/ --- # avis_google Mit Konto · Schreibt (bestätigen) · Tarif Wachstum. Die Google-Bewertungen des Ladens. Jeder Kunde erhält dieselbe Bewertungsanfrage (Wallet-Benachrichtigung, SMS oder E-Mail je nach dem in regler_automatismes, canal_avis, eingestellten Kanal), mit dem direkten Link zum Google-Unternehmensprofil: keine Zwischenbewertung, keine Vorauswahl, keine Belohnung für eine Bewertung (Regeln von Google). Zeigt die Zahlen der letzten 30 Tage (verschickte Anfragen, Kunden, die zu Google gegangen sind); und stellt die Anfrage ein: Link zum Google-Profil, Anfrage aktiv oder nicht, Zeitpunkt (erste Prämie oder nach N Besuchen), Verzögerung, Text. Ohne Änderung: nur Lesen. Mit Änderungen: confirmer=false liefert eine Vorschau vorher → nachher, confirmer=true speichert. Nur die angegebenen Felder ändern sich. ## Parameter - `lien` (string, ≤ 2000 Zeichen, optional) : Link „Bewertung schreiben“ des Google-Unternehmensprofils (g.page/r/…/review, search.google.com/local/writereview?placeid=…). Ohne ihn geht keine Anfrage raus. - `retirer_lien` (boolean, optional) : true: entfernt den Link zum Profil (stoppt faktisch alle Anfragen). - `demande_active` (boolean, optional) : Die Bewertungsanfrage an die Kunden senden oder nicht. - `moment` (enum, optional) : Wann gefragt wird: recompense = bei der ersten Prämie; passages = nach N Besuchen (siehe passages). Werte : recompense, passages. - `passages` (integer, 1…50, optional) : Anzahl der Besuche vor der Anfrage, wenn moment=passages. - `delai_minutes` (integer, optional) : Abstand zwischen Besuch und Anfrage, in Minuten: 0, 30, 60, 180, 1440 (1440 = am nächsten Tag). - `texte_demande` (string, ≤ 300 Zeichen, optional) : Text der Anfrage, höchstens 300 Zeichen. Der Link zum Google-Profil wird danach angehängt. - `effacer` (array, optional) : Textfelder, die geleert werden. texte_demande kehrt zum Standardtext zurück. Werte : texte_demande. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Frag nach dem 3. Besuch nach einer Google-Bewertung, eine Stunde danach. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "avis_google", "arguments": { "demande_active": true, "moment": "passages", "passages": 3, "delai_minutes": 60, "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"avis_google","arguments":{"demande_active":true,"moment":"passages","passages":3,"delai_minutes":60,"confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/avis_google/ --- # voir_carte Mit Konto · Nur Lesen. Zeigt die Kundenkarte des Ladens so, wie die Kunden sie in Apple Wallet und Google Wallet sehen, mit ihren aktuellen Regeln: Modus (Stempel, Stufen oder Punkte), Prämien und Schwellen, geschenkte Stempel bei der Anmeldung, Ablauf der Prämien, Einstellungen der Punkte, Stil, Farbe, Stempel und der öffentliche Anmeldelink für Kunden. Vor jeder Änderung verwenden (modifier_carte nutzt dieselben Namen für die Einstellungen) oder wenn der Ladeninhaber fragt, wie seine Karte aussieht oder welche Regel sie hat. Nur Lesen. ## Parameter - `variantes` (boolean, optional) : true: zeigt auch die drei Paletten der aktuellen Kollektion, um einen Farbwechsel vorzuschlagen (danach als „palette“ an modifier_carte übergeben). Standard : false. - `tampons_poses` (integer, 0…1000000, optional) : In der Vorschau gesetzte Stempel (oder Punkte), um eine angefangene Karte zu zeigen (Standard: Willkommensstempel + 2). - `qr` (boolean, optional) : true: hängt den Anmelde-QR-Code für Kunden an (den vom Aufsteller), um die Karte auf dem eigenen Telefon auszuprobieren. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. ## Beispiel Prompt : « Zeig mir meine Karte, mit den anderen möglichen Paletten. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "voir_carte", "arguments": { "variantes": true } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"voir_carte","arguments":{"variantes":true}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/voir_carte/ --- # modifier_carte Mit Konto · Schreibt (bestätigen). Ändert eine oder mehrere Einstellungen der Kundenkarte des Ladens in einem einzigen Aufruf: aufgedruckter Name, Stil (Kollektion, Palette oder freie Farbe), Stempel, Prämienregel (Modus tampons/paliers/points, Schwellen, Prämien), geschenkte Stempel bei der Anmeldung, Ablauf der Prämien, im Modus paliers die Form der Karte (forme_paliers: tampons oder eine der fünf Formen) und im Modus points der Name der Punkte, die Form der Karte (forme_points), der Standardwert eines Besuchs, die Schnellwerte und die Punkte pro Euro. Nur die angegebenen Einstellungen ändern sich; zuerst die Karte mit voir_carte lesen. Mit confirmer=false (Standard) aufrufen, um vorher/nachher zu zeigen, dann mit confirmer=true nach ausdrücklicher Zustimmung. Eine Regeländerung gilt auch für Karten, die die Kunden schon haben. Die Bilder (Logo, Hintergrund, Stempel als Bild) ändern Sie in der App, Seite Karte. ## Parameter - `nom` (string, ≤ 80 Zeichen, optional) : Name des Ladens, oben auf die Karte gedruckt. - `mode` (enum, optional) : tampons: eine Prämie bei einer Schwelle (am einfachsten). paliers: mehrere Prämien auf derselben Karte (z. B. 5 und 10). points: Der Ladeninhaber gibt bei jedem Besuch eine Anzahl Punkte ein (unterschiedliche Einkaufsbeträge). Werte : tampons, paliers, points. - `recompense` (string, ≤ 120 Zeichen, optional) : Die Prämie (Modus tampons). Wird ignoriert, wenn „paliers“ angegeben ist. - `tampons` (integer, 2…30, optional) : Anzahl der Besuche bis zur Prämie (Modus tampons), von 2 bis 30. - `paliers` (array, ≤ 6, optional) : Die Prämien und ihre Schwellen (Modi paliers und points). Von der kleinsten zur größten. - `paliers[].a` (integer, 1…1000000, Pflicht) : Schwelle: Anzahl Stempel (oder Punkte im Modus points), um diese Stufe zu erreichen. - `paliers[].recompense` (string, ≤ 120 Zeichen, Pflicht) : Was der Kunde bekommt, so wie es auf der Karte steht. Z. B. „Ein Kaffee gratis“. - `paliers[].icone` (enum, optional) : Icon der Stufe (Standard: cadeau). Werte : etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette, cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau, feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion, croissant. - `collection` (enum, optional) : Stil der Karte: original (schlicht), cafe (feiner Rahmen), botanique (kursiv, Blätter), trattoria (gewellter Rand), atelier (modern), pass (wie ein Apple Wallet Pass: großes Logo, Stempel als Objekte mit Schatten, kräftiger Hintergrund). Werte : original, cafe, botanique, trattoria, atelier, pass. - `palette` (integer, 0…3, optional) : Palette der Kollektion: 0, 1 oder 2 (jede Kollektion bietet drei; pass bietet eine vierte, 3). Wird ignoriert, wenn „couleur“ angegeben ist. - `couleur` (string, optional) : Freie Hintergrundfarbe, hexadezimal. Die Schriftfarbe (Text) wird automatisch so gewählt, dass sie lesbar bleibt. - `tampon` (enum, optional) : Das Zeichen, das bei jedem Besuch gesetzt wird. „rond“: der einfache Punkt. Beauty: etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette. Food: cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau. Sonstiges: feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion. Werte : rond, etincelle, eclat, goutte, main, pinceau, oeil, ciseaux, sechoir, fleur, lotus, coeur, etoile, diamant, couronne, soleil, lune, talon, robe, sac, serviette, cafe, grain, the, cookie, gateau, pain, part, burger, glace, bol, plat, verre, biere, bulles, cocktail, cerises, orange, avocat, piment, oeuf, poisson, fromage, popcorn, couteau, carotte, bocal, esquimau, feuille, flamme, eclair, sourire, patte, chien, chat, cadeau, haltere, velo, livre, note, appareil, palette, dent, parapluie, ballon, tshirt, basket, tulipe, plante, os, cintre, lavelinge, voiture, cle, botte, montagne, trophee, des, camion, croissant. - `tampons_bienvenue` (integer, 0…5, optional) : Stempel, die der Kunde bei der Anmeldung geschenkt bekommt (0 bis 5). Standard 1: Eine angefangene Karte will man vollmachen. - `nom_des_points` (string, ≤ 20 Zeichen, optional) : Modus points: wie die Punkte heißen („Punkte“, „Bohnen“, „Sterne“…). - `forme_paliers` (enum, optional) : Modus paliers: das Aussehen der Karte. tampons (Standard): die Stempel im Raster, jede Prämie an der Stelle des Stempels ihrer Schwelle. Oder eine der fünf Formen der Punkte, die dann Stempel zählt: medailles (ein Balken und eine Medaille pro Prämie), vitrine (die Prämien nebeneinander, jede mit eigenem Balken), remplissage (die nächste Prämie in groß, die sich einfärbt), chemin (ein Weg in S-Form, auf dem jeder Stempel den Marker voranbringt), anneau (ein runder Balken um die nächste Prämie). Die Fotos der Prämien laden Sie in der App hoch, Seite Karte. Werte : tampons, medailles, vitrine, remplissage, chemin, anneau. - `forme_points` (enum, optional) : Modus points: das Aussehen der Karte. medailles (Standard): ein dicker Balken und eine große Medaille pro Prämie. vitrine: die Prämien nebeneinander, jede mit eigenem kleinen Balken. remplissage: die nächste Prämie in groß, die sich nach und nach einfärbt. chemin: ein Weg in S-Form, die Prämien als Etappen. anneau: ein runder Balken um die nächste Prämie, die Liste daneben. Die Fotos der Prämien laden Sie in der App hoch, Seite Karte. Werte : medailles, vitrine, remplissage, chemin, anneau. - `expiration_recompense_jours` (integer, 0…365, optional) : Tage, die eine verdiente Prämie gültig bleibt: 0, 30, 60, 90, 180, 365 (0 = läuft nicht ab). - `points_par_defaut` (integer, 1…100000, optional) : Modus points: Punkte, die standardmäßig bei jedem Besuch gesetzt werden (1 bis 100 000). - `points_raccourcis` (array, ≤ 12, optional) : Modus points: die Werte, die beim Scannen mit einem Tippen angeboten werden (bis zu 6, sortiert und ohne Doppelte). Z. B. [1, 2, 5, 10]. - `points_par_euro` (number, 0.01…10000, optional) : Modus points: Punkte pro ausgegebenem Euro, Richtwert für den Ladeninhaber (z. B. 1 oder 0,5). - `conversion` (number, 0.01…100000, optional) : Passage tampons ↔ points seulement : combien de points vaut UN tampon (ex. 15). Les soldes des cartes ouvertes et, si aucune récompense n’est donnée, les seuils sont convertis avec. Défaut : le dernier ratio choisi, sinon le panier moyen en points, sinon 10. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Stell meine Karte auf Stufen um: ein Kaffee nach 5 Besuchen, ein Croissant nach 10. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "modifier_carte", "arguments": { "mode": "paliers", "paliers": [ { "a": 5, "recompense": "Ein Kaffee gratis", "icone": "cafe" }, { "a": 10, "recompense": "Ein Croissant gratis", "icone": "croissant" } ], "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"modifier_carte","arguments":{"mode":"paliers","paliers":[{"a":5,"recompense":"Ein Kaffee gratis","icone":"cafe"},{"a":10,"recompense":"Ein Croissant gratis","icone":"croissant"}],"confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/modifier_carte/ --- # fiche_commerce Mit Konto · Schreibt (bestätigen). Liest oder ändert das Profil des Ladens: Name, Art des Ladens, Durchschnittsbon (dient den Schätzungen im Dashboard), Sprache der Kunden, Kontaktdaten auf der Rückseite der Karte (Adresse, Telefon, Öffnungszeiten, Website, Begrüßungstext), öffentlicher Anmeldelink für Kunden (stampywallet.com/rejoindre/, der des QR-Codes) und die Orte, an denen die Karte erscheinen kann, wenn ein Kunde vorbeigeht, sofern sein Telefon es zulässt (bis zu 10: Laden, Markt, Standplatz eines Foodtrucks), mit ihren Tagen und Uhrzeiten. Ohne Änderungsparameter: liefert das aktuelle Profil. Mit Änderungen: confirmer=false (Standard) zeigt vorher/nachher, confirmer=true schreibt nach ausdrücklicher Zustimmung. Ein alter öffentlicher Link funktioniert nach einer Änderung weiter (bereits gedruckte QR-Codes bleiben gültig). ## Parameter - `nom` (string, ≤ 80 Zeichen, optional) : Name des Ladens (wird auch auf die Karte gedruckt). - `metier` (enum, optional) : Art des Ladens, eine der Branchen aus der Anmeldung. „autre“: alles, was keine eigene Branche hat. Werte : cafe, boulangerie, patisserie, glacier, restaurant, creperie, sushi, snack, foodtruck, boucherie, fromagerie, primeur, vrac, ongles, institut, barbier, boutique, fleuriste, librairie, animalerie, pressing, cordonnerie, laverie, lavage, toilettage, sport, escalade, loisirs, autre. - `panier_moyen` (number, 0.01…100000, optional) : Durchschnittliche Ausgabe eines Kunden pro Besuch, in Euro. - `langue` (enum, optional) : Sprache des Ladens: die der Karte, der Seiten und der Nachrichten, die die Kunden sehen. Werte : fr, en, es, de. - `adresse` (string, ≤ 160 Zeichen, optional) : Adresse, auf der Rückseite der Karte (höchstens 160 Zeichen). - `telephone` (string, ≤ 30 Zeichen, optional) : Telefon, auf der Rückseite der Karte. - `horaires` (string, ≤ 120 Zeichen, optional) : Öffnungszeiten, als freier Text (z. B. „Di–Sa 7–19 Uhr“). - `site_web` (string, ≤ 160 Zeichen, optional) : Website oder Instagram-Seite. - `message_bienvenue` (string, ≤ 180 Zeichen, optional) : Kurzer Gruß auf der Rückseite der Karte, den der Kunde beim Hinzufügen liest. - `lien` (string, ≤ 120 Zeichen, optional) : Gewünschter öffentlicher Link, im Klartext („Bäckerei am Bahnhof“ wird zu „baeckerei-am-bahnhof“), 3 bis 32 Zeichen. Ein Link, den schon ein anderer Laden nutzt, wird abgelehnt. - `lieux_ajouter` (array, ≤ 10, optional) : Orte, die für die Nähe-Erinnerung hinzugefügt werden (die Karte kann erscheinen, wenn ein Kunde vorbeigeht, sofern sein Telefon es zulässt): Markt, Standplatz eines Foodtrucks… Insgesamt höchstens 10 Orte, Hauptadresse eingeschlossen. Jeder mit einer Adresse oder Koordinaten. - `lieux_ajouter[].nom` (string, ≤ 40 Zeichen, Pflicht) : Kurzer Name des Ortes („Laden“, „Sonntagsmarkt“), höchstens 40 Zeichen. - `lieux_ajouter[].adresse` (string, ≤ 160 Zeichen, optional) : Adresse, nach der gesucht wird, um den Punkt zu setzen (geokodiert über die Base Adresse Nationale oder OpenStreetMap; die Vorschau zeigt, was gefunden wurde). - `lieux_ajouter[].coordonnees` (string, ≤ 400 Zeichen, optional) : Oder Koordinaten „45.7640, 4.8357“, oder ein Link von Google Maps / OpenStreetMap. - `lieux_ajouter[].jours` (array, ≤ 7, optional) : Tage, an denen der Ort aktiv ist. Fehlt der Wert oder steht „tous“: jeden Tag. Werte : dimanche, lundi, mardi, mercredi, jeudi, vendredi, samedi, tous. - `lieux_ajouter[].heure_debut` (string, optional) : Beginn des Zeitfensters, „HH:MM“ (optional, wird auf die Rückseite der Karte geschrieben: Telefone aktivieren einen Ort nur für den ganzen Tag). - `lieux_ajouter[].heure_fin` (string, optional) : Ende des Zeitfensters, „HH:MM“. - `lieux_modifier` (array, ≤ 10, optional) : Orte, die umbenannt, verlegt (Adresse oder Koordinaten) oder neu geplant werden (Tage, Zeitfenster). Die angegebenen Tage ersetzen die alten; ohne Tage und Uhrzeiten ändert sich die Planung nicht. - `lieux_modifier[].lieu` (string, ≤ 40 Zeichen, Pflicht) : Der zu ändernde Ort: seine Kennung (aus dem Lesen des Profils) oder „principal“ (der Ort der Adresse auf der Rückseite der Karte). - `lieux_modifier[].nom` (string, ≤ 40 Zeichen, optional) : Kurzer Name des Ortes („Laden“, „Sonntagsmarkt“), höchstens 40 Zeichen. - `lieux_modifier[].adresse` (string, ≤ 160 Zeichen, optional) : Adresse, nach der gesucht wird, um den Punkt zu setzen (geokodiert über die Base Adresse Nationale oder OpenStreetMap; die Vorschau zeigt, was gefunden wurde). - `lieux_modifier[].coordonnees` (string, ≤ 400 Zeichen, optional) : Oder Koordinaten „45.7640, 4.8357“, oder ein Link von Google Maps / OpenStreetMap. - `lieux_modifier[].jours` (array, ≤ 7, optional) : Tage, an denen der Ort aktiv ist. Fehlt der Wert oder steht „tous“: jeden Tag. Werte : dimanche, lundi, mardi, mercredi, jeudi, vendredi, samedi, tous. - `lieux_modifier[].heure_debut` (string, optional) : Beginn des Zeitfensters, „HH:MM“ (optional, wird auf die Rückseite der Karte geschrieben: Telefone aktivieren einen Ort nur für den ganzen Tag). - `lieux_modifier[].heure_fin` (string, optional) : Ende des Zeitfensters, „HH:MM“. - `lieux_retirer` (array, ≤ 10, optional) : Orte, die entfernt werden, nach Kennung. „principal“ entfernt nur den Punkt der Adresse (er kommt zurück, wenn sich die Adresse ändert). - `effacer` (array, ≤ 6, optional) : Felder, die geleert werden. „lien“: Die öffentliche Adresse wird wieder die technische Kennung (der Link bleibt für diesen Laden reserviert). Werte : adresse, telephone, horaires, site_web, message_bienvenue, lien. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Schreib meine Öffnungszeiten auf die Rückseite der Karte: Dienstag bis Samstag, 7 bis 19 Uhr. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "fiche_commerce", "arguments": { "horaires": "Di–Sa 7–19 Uhr", "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fiche_commerce","arguments":{"horaires":"Di–Sa 7–19 Uhr","confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/fiche_commerce/ --- # affichette Mit Konto · Nur Lesen. Liefert den Anmelde-QR-Code für Kunden (der an der Theke steht und den die Kunden scannen, um die Karte auf ihr Telefon zu holen), den öffentlichen Link, die Karte und die Download-Links für den Aufsteller zum Ausdrucken (PDF A5 oder A6) und für den QR-Code allein (PNG, SVG) für eine Speisekarte, ein Schaufenster oder Canva. Verwenden, wenn der Ladeninhaber seinen Aufsteller drucken, seinen QR-Code oder den Link für seine Bio holen möchte. Die Downloads öffnen sich in der App, angemeldet. Um die PDFs per E-Mail zu bekommen: envoyer_affichette. Nur Lesen. ## Parameter - `format` (enum, optional) : Format des hervorgehobenen PDFs: a5 (halbes Blatt, Aufsteller für die Theke) oder a6 (Viertelblatt, Tischaufsteller oder Kartenhalter). Werte : a5, a6. Standard : "a5". ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. ## Beispiel Prompt : « Gib mir meinen QR-Code und den Aufsteller zum Ausdrucken. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "affichette", "arguments": { "format": "a5" } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"affichette","arguments":{"format":"a5"}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/affichette/ --- # envoyer_affichette Mit Konto · Schreibt (bestätigen). Schickt den Thekenaufsteller (PDF A5 und A6, mit dem Anmelde-QR-Code für Kunden) an die E-Mail-Adresse des verbundenen StampyWallet-Kontos, um ihn von einem anderen Gerät oder in einer Druckerei zu drucken. Nur an diese Adresse, nie an eine andere. Mit confirmer=false (Standard) aufrufen, um den Versand anzukündigen, dann confirmer=true nach Zustimmung. ## Parameter - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Schick mir den Aufsteller per E-Mail, damit ich ihn drucken kann. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "envoyer_affichette", "arguments": { "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"envoyer_affichette","arguments":{"confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/envoyer_affichette/ --- # lister_equipe Mit Konto · Nur Lesen · Nur Inhaber. Listet das Team des Ladens (Name, E-Mail, Rolle, gesetzte Stempel) und die offenen Einladungen mit ihrem Link. Ändert nichts. Nur für den Inhaber. ## Parameter Keine Parameter. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. ## Beispiel Prompt : « Wer gehört zu meinem Team, und welche Einladungen sind noch offen? » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "lister_equipe", "arguments": {} } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"lister_equipe","arguments":{}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/lister_equipe/ --- # inviter_membre Mit Konto · Schreibt (bestätigen) · Nur Inhaber. Erstellt eine persönliche Einladung, 14 Tage gültig, als Mitarbeiter (nur Scanner) oder Verantwortlicher (Zahlen, Kunden, Nachrichten, Karte). Mit „email“ geht sie per E-Mail an die Person; sonst wird der Link zum Weitergeben geliefert. Einen Inhaber ernennen Sie in der App. Nur für den Inhaber. confirmer=false (Standard) liefert eine Vorschau; confirmer=true handelt, nach ausdrücklicher Zustimmung der Person. ## Parameter - `email` (string, ≤ 254 Zeichen, optional) : Adresse der eingeladenen Person: Die Einladung wird ihr per E-Mail geschickt. Ohne Adresse wird der Link zurückgegeben. - `nom` (string, ≤ 60 Zeichen, optional) : Notiz zur Orientierung in den Einladungen (z. B. „Julie, Frühschicht“). - `role` (enum, optional) : staff (Standard) = Mitarbeiter, sieht nur den Scanner; manager = Verantwortlicher, sieht Zahlen, Kunden, Nachrichten und stellt die Karte ein. Werte : staff, manager. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Lade Julie als Mitarbeiterin ein, ihre E-Mail ist julie@example.com. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "inviter_membre", "arguments": { "email": "julie@example.com", "nom": "Julie, Frühschicht", "role": "staff", "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"inviter_membre","arguments":{"email":"julie@example.com","nom":"Julie, Frühschicht","role":"staff","confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/inviter_membre/ --- # changer_role_membre Mit Konto · Schreibt (bestätigen) · Nur Inhaber. Macht ein Teammitglied zum Mitarbeiter oder zum Verantwortlichen. Nur für den Inhaber. confirmer=false (Standard) liefert eine Vorschau; confirmer=true handelt, nach ausdrücklicher Zustimmung der Person. ## Parameter - `membre_id` (string, ≤ 36 Zeichen, optional) : Kennung des Mitglieds, gelesen mit lister_equipe. - `email` (string, ≤ 254 Zeichen, optional) : Oder die E-Mail des Mitglieds, statt membre_id. - `role` (enum, Pflicht) : staff = Mitarbeiter, sieht nur den Scanner; manager = Verantwortlicher, sieht Zahlen, Kunden, Nachrichten und stellt die Karte ein, ohne das Team zu verwalten. Werte : staff, manager. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Mach Julie zur Verantwortlichen. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "changer_role_membre", "arguments": { "email": "julie@example.com", "role": "manager", "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"changer_role_membre","arguments":{"email":"julie@example.com","role":"manager","confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/changer_role_membre/ --- # retirer_membre Mit Konto · Schreibt (bestätigen) · Nur Inhaber. Entzieht einem Mitglied den Zugang zum Laden und beendet seine offenen Sitzungen. Die Stempel, die es gesetzt hat, bleiben im Verlauf. Nur für den Inhaber. confirmer=false (Standard) liefert eine Vorschau; confirmer=true handelt, nach ausdrücklicher Zustimmung der Person. ## Parameter - `membre_id` (string, ≤ 36 Zeichen, optional) : Kennung des Mitglieds, gelesen mit lister_equipe. - `email` (string, ≤ 254 Zeichen, optional) : Oder die E-Mail des Mitglieds, statt membre_id. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Julie ist nicht mehr bei uns, nimm ihr den Zugang. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "retirer_membre", "arguments": { "email": "julie@example.com", "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"retirer_membre","arguments":{"email":"julie@example.com","confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/retirer_membre/ --- # annuler_invitation Mit Konto · Schreibt (bestätigen) · Nur Inhaber. Storniert eine noch nicht genutzte Einladung: Ihr Link funktioniert nicht mehr. Nur für den Inhaber. confirmer=false (Standard) liefert eine Vorschau; confirmer=true handelt, nach ausdrücklicher Zustimmung der Person. ## Parameter - `invitation` (string, ≤ 300 Zeichen, Pflicht) : Der Einladungslink oder sein Token, gelesen mit lister_equipe. - `confirmer` (boolean, optional) : false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen. Standard : false. ## Antwort Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann. > **Achtung :** Dieses Werkzeug schreibt. Mit `confirmer: false` (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit `confirmer: true` erneut aufruft. ## Beispiel Prompt : « Storniere die Einladung, die an Julie gegangen ist. » ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "annuler_invitation", "arguments": { "invitation": "https://app.stampywallet.com/pro/rejoindre/abc123", "confirmer": false } } } ``` ```bash curl https://app.stampywallet.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $STAMPY_JETON" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"annuler_invitation","arguments":{"invitation":"https://app.stampywallet.com/pro/rejoindre/abc123","confirmer":false}}}' ``` `$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun. Source : https://stampywallet.com/de/docs/mcp/werkzeuge/annuler_invitation/ --- # Die StampyWallet-API Erfassen Sie Besuche, legen Sie Kunden an und empfangen Sie die Ereignisse Ihrer Stempelkarte aus Ihrer Kasse, Ihrer Website oder einem No-Code-Tool. Die API verbindet StampyWallet mit dem Rest Ihres Geschäfts. Sie funktioniert in beide Richtungen: - **Zu StampyWallet**: Ihre Kasse, Ihre Website oder Ihre Buchungssoftware erfasst einen Besuch, legt einen Kunden an oder löst eine Prämie ein, ohne Scan an der Theke. - **Von StampyWallet**: Bei jedem Besuch, jeder neuen Karte oder Prämie ruft StampyWallet eine Adresse Ihrer Wahl auf (einen [Webhook](https://stampywallet.com/de/docs/api/webhooks/)). So füllen Sie eine Tabelle, ein CRM oder ein Zapier-Szenario. > **Bevor Sie anfangen :** die API, die Eingangsadressen für Kassen ([Kasse anbinden](https://stampywallet.com/de/docs/api/kasse-anbinden/)) und die Webhooks sind im Tarif **Wachstum** enthalten (40 € zzgl. MwSt. pro Monat) und während der kostenlosen Testphase freigeschaltet. Im Tarif Essential antworten die Aufrufe mit `403` und dem Code `formule_requise`. > **Achtung :** die API ist in der **Beta**. Die hier beschriebenen Routen und Felder entsprechen der Implementierung; vor der stabilen Version können neue Felder hinzukommen: Ignorieren Sie die, die Sie nicht kennen. Änderungen werden in den [Neuigkeiten](https://stampywallet.com/de/neuigkeiten/) angekündigt. ## Die Basisadresse Alle Routen laufen über HTTPS, im JSON-Format (Feldnamen auf Französisch, in snake_case), unter: ```text title="Basisadresse" https://app.stampywallet.com/v1 ``` IDs sind UUIDs; Beträge sind in der Währung des Geschäfts angegeben, in Einheiten (`12.5` für 12,50 €). ## Ein erster Aufruf Erstellen Sie einen Schlüssel unter **Einstellungen › Integrationen** (siehe [Authentifizierung](https://stampywallet.com/de/docs/api/authentifizierung/)) und rufen Sie dann die Daten Ihres Geschäfts ab: ```bash title="curl" curl https://app.stampywallet.com/v1/commerce \ -H "Authorization: Bearer sw_live_votre_cle" ``` ```js title="Node.js" const reponse = await fetch('https://app.stampywallet.com/v1/commerce', { headers: { Authorization: `Bearer ${process.env.STAMPY_CLE}` }, }); console.log(await reponse.json()); ``` ```python title="Python" import os, requests reponse = requests.get( "https://app.stampywallet.com/v1/commerce", headers={"Authorization": f"Bearer {os.environ['STAMPY_CLE']}"}, ) print(reponse.json()) ``` ## Was die API kann | Route | Zweck | |---|---| | `GET /v1/commerce` | [Die Daten des Geschäfts abrufen](https://stampywallet.com/de/docs/api/geschaeft/) und die Regeln der Karte | | `POST /v1/clients` | [Einen Kunden anlegen](https://stampywallet.com/de/docs/api/kunden-anlegen/) und den Link zu seiner Karte erhalten | | `GET /v1/clients` | [Einen Kunden finden](https://stampywallet.com/de/docs/api/kunden-finden/) über Telefon, E-Mail oder Karte | | `GET /v1/clients/:id` | [Einen Kunden abrufen](https://stampywallet.com/de/docs/api/kunden-abrufen/) und den Stand seiner Karte | | `POST /v1/passages` | [Einen Besuch erfassen](https://stampywallet.com/de/docs/api/besuch-erfassen/): einen Stempel, oder Punkte je nach Betrag | | `DELETE /v1/passages/:id` | [Einen Besuch stornieren](https://stampywallet.com/de/docs/api/besuch-stornieren/) | | `POST /v1/recompenses` | [Eine verdiente Prämie einlösen](https://stampywallet.com/de/docs/api/praemie-einloesen/) | | `POST /v1/entrants/:jeton` | [Die Verkäufe Ihrer Kasse empfangen](https://stampywallet.com/de/docs/api/kassen-eingang/) (Square, Shopify, SumUp, Zettle oder das generische Format) | Und in die andere Richtung die [ausgehenden Webhooks](https://stampywallet.com/de/docs/api/webhooks/): neun signierte [Ereignisse](https://stampywallet.com/de/docs/api/ereignisse/). > **Tipp :** kein Entwickler zur Hand? Die Seite [Kasse anbinden](https://stampywallet.com/de/docs/api/kasse-anbinden/) erklärt die Einstellungen Schritt für Schritt für Square, Shopify, SumUp und Zettle sowie für Zapier, Make und n8n. ## Und MCP? Die API ist für Software gedacht: eine Kasse, eine Website, ein Skript. Um Ihr Geschäft **im Gespräch** zu steuern, aus Claude, ChatGPT oder Cursor heraus, nutzen Sie besser den [MCP-Server](https://stampywallet.com/de/docs/mcp/verbinden/): Er braucht keinen Schlüssel, Sie verbinden nur Ihr Konto. ## Häufige Fragen **Was kostet die API?** Die API, die Eingangsadressen für Kassen und die Webhooks sind im Tarif Wachstum enthalten, für 40 € zzgl. MwSt. pro Monat, und während der 30 Tage kostenlosen Testphase freigeschaltet. Im Tarif Essential antworten die Aufrufe mit `403`. **Brauche ich einen Entwickler, um meine Kasse anzubinden?** Nicht für Square, Shopify, SumUp, Zettle, Zapier, Make oder n8n: Die Seite [Kasse anbinden](https://stampywallet.com/de/docs/api/kasse-anbinden/) erklärt die Einstellungen Schritt für Schritt. Wer die API aus eigener Software aufrufen will, braucht dagegen jemanden, der Code schreibt. **Gibt es ein Aufruflimit?** Ja: 120 Anfragen pro Minute und Schlüssel. Darüber hinaus lautet die Antwort `429` mit dem Header `Retry-After`. **Gilt ein Schlüssel für mehrere Filialen?** Nein. Ein Schlüssel gibt nur Zugriff auf das Geschäft, in dem er erstellt wurde: Erstellen Sie in jeder Filiale einen eigenen Schlüssel. **Wie vermeide ich einen doppelten Stempel, wenn meine Kasse es erneut versucht?** Geben Sie jedem Besuch eine `reference`, zum Beispiel die Bonnummer, und senden Sie bei jedem `POST` einen Header `Idempotency-Key`: Ein erneuter Versuch stempelt nicht zweimal. Source : https://stampywallet.com/de/docs/api/ --- # Authentifizierung Jeder API-Aufruf trägt einen geheimen Schlüssel sw_live_, erstellt unter Einstellungen › Integrationen und nur einmal angezeigt. 120 Anfragen pro Minute und Schlüssel. ## Einen Schlüssel erstellen 1. **Öffnen Sie Einstellungen › Integrationen** in Ihrem StampyWallet-Bereich (als Inhaber oder Manager). 2. **Erstellen Sie einen Schlüssel** und geben Sie ihm einen Namen, der sagt, wofür er dient („Kasse an der Theke“, „Website“). 3. **Kopieren Sie ihn sofort.** Er beginnt mit `sw_live_` und wird nur ein einziges Mal vollständig angezeigt: StampyWallet speichert nur einen Hash davon. Geht er verloren, lässt er sich nicht wiederherstellen: Widerrufen Sie ihn und erstellen Sie einen neuen. ## Bei jedem Aufruf mitsenden Der Schlüssel steht im Header `Authorization`, nach dem Wort `Bearer`: ```http title="Header" Authorization: Bearer sw_live_4f9c2a7e1b... ``` Ein Schlüssel gibt Zugriff auf **ein** Geschäft: das, in dem er erstellt wurde. Wenn Sie mehrere Filialen führen, erstellen Sie in jeder einen Schlüssel. > **Achtung :** der Schlüssel handelt in Ihrem Namen: Er legt Kunden an und erfasst Besuche. Bewahren Sie ihn auf dem Server auf (Umgebungsvariable, Secret-Speicher), niemals im Code einer Webseite oder einer mobilen App, niemals in einem Git-Repository. ## Einen Schlüssel widerrufen Widerrufen Sie den Schlüssel unter **Einstellungen › Integrationen**: Aufrufe mit diesem Schlüssel schlagen sofort mit `401` und dem Code `cle_revoquee` fehl. Tun Sie das, sobald ein Schlüssel nach außen gelangt sein könnte oder ein Dienstleister ihn nicht mehr braucht. ## Zugriffsfehler | Status | `code` | Wann | |---|---|---| | `401` | `non_authentifie` | Header fehlt oder Schlüssel unbekannt | | `401` | `cle_revoquee` | Der Schlüssel wurde widerrufen | | `403` | `formule_requise` | Das Geschäft hat nicht den Tarif Wachstum (die API ist darin enthalten und während der Testphase freigeschaltet) | | `403` | `interdit` | Die Aktion ist für dieses Geschäft nicht erlaubt | | `429` | `trop_de_requetes` | Mehr als 120 Anfragen pro Minute mit diesem Schlüssel | ## Das Ratenlimit **120 Anfragen pro Minute und Schlüssel.** Darüber hinaus lautet die Antwort `429` mit dem Header `Retry-After: 60`: Warten Sie diese Anzahl Sekunden, bevor Sie weitermachen. Eine normale Kasse ist weit davon entfernt. Alle Details zum Fehlerformat finden Sie auf der Seite [Fehler](https://stampywallet.com/de/docs/api/fehler/). Source : https://stampywallet.com/de/docs/api/authentifizierung/ --- # Fehler und Wiederholungen Das Fehlerformat der API, alle Fehlercodes und der Header Idempotency-Key, um einen POST ohne Risiko einer Dublette zu wiederholen. ## Das Format eines Fehlers Ein Fehler antwortet mit einem HTTP-Status 4xx oder 5xx und immer demselben Body: ```json title="Fehlerantwort" { "erreur": { "code": "client_introuvable", "message": "Kein passender Kunde in diesem Geschäft." } } ``` - `code` ist stabil: Diesen Wert sollte Ihr Programm prüfen. - `message` ist ein lesbarer Satz für Ihre Logs. Der Text kann sich ändern. ## Die Codes | Status | Codes | |---|---| | `400` | `requete_invalide` (JSON nicht lesbar), `client_requis`, `recherche_requise`, `montant_invalide`, `quantite_invalide`, `points_invalide`, `email_invalide`, `telephone_invalide`, `idempotency_key_invalide` | | `401` | `non_authentifie`, `cle_revoquee`, `signature_invalide` (Eingangsadressen) | | `403` | `formule_requise` (die API erfordert den Tarif Wachstum), `interdit` | | `404` | `introuvable` (Adresse), `client_introuvable`, `passage_introuvable` | | `409` | `trop_tot`, `pas_dernier`, `deja_annule`, `recompense_offerte`, `aucune_recompense`, `requete_en_cours` | | `422` | `conditions_requises`, `montant_insuffisant` | | `429` | `trop_de_requetes` (siehe [das Ratenlimit](https://stampywallet.com/de/docs/api/authentifizierung/#limite)) | | `500` | `interne`: Versuchen Sie es später erneut, mit demselben `Idempotency-Key` | ## Wiederholen ohne Dublette: Idempotency-Key Die Verbindung bricht im falschen Moment ab, und Sie wissen nicht, ob der Besuch gespeichert wurde. Um ohne Risiko erneut zu senden, schicken Sie bei jedem `POST` (`/clients`, `/passages`, `/recompenses`) einen Header `Idempotency-Key` mit: ein eindeutiger Wert pro Vorgang, 1 bis 200 Zeichen lang, zum Beispiel die Bonnummer. ```bash title="curl" curl https://app.stampywallet.com/v1/passages \ -H "Authorization: Bearer sw_live_votre_cle" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: ticket-2026-10-25-0042" \ -d '{"client": {"telephone": "+33612345678"}, "montant": 12.50}' ``` - Die Antwort wird **24 Stunden** aufbewahrt. Derselbe Schlüssel noch einmal gesendet liefert denselben Status und denselben Body, mit dem Header `Idempotent-Replayed: true`. - Ein `4xx`-Fehler wird ebenfalls aufbewahrt: Eine Wiederholung liefert denselben Fehler. Ein `500`-Fehler gibt den Schlüssel frei, damit Sie es erneut versuchen können. - Solange die erste Anfrage noch läuft: `409 requete_en_cours`. > **Tipp :** bei [`POST /v1/passages`](https://stampywallet.com/de/docs/api/besuch-erfassen/) schützt auch das Feld `reference` (Ihre Bonnummer): Dieselbe Referenz stempelt pro Geschäft nur einmal, auch ohne `Idempotency-Key`. Source : https://stampywallet.com/de/docs/api/fehler/ --- # Geschäft abrufen GET /v1/commerce liefert die Daten des Geschäfts, zu dem der Schlüssel gehört, und die Regeln seiner Stempelkarte. `GET /v1/commerce` Liefert das Geschäft, zu dem der Schlüssel gehört: Name, Währung, Zeitzone und die Regeln der Karte (Modus, Ziel, Prämien, Betragsregel). Praktisch, um einen Schlüssel zu prüfen oder die Regel der Karte in Ihrer Kasse anzuzeigen. ## Beispiel ```bash title="curl" curl https://app.stampywallet.com/v1/commerce \ -H "Authorization: Bearer sw_live_votre_cle" ``` ```js title="Node.js" const r = await fetch('https://app.stampywallet.com/v1/commerce', { headers: { Authorization: `Bearer ${process.env.STAMPY_CLE}` }, }); const commerce = await r.json(); ``` ## Antwort ```json title="200 OK" { "id": "5f0c8e2a-3b1d-4c9e-9a51-2d7f3e8b6a10", "nom": "Boulangerie Lemaire", "mode": "tampons", "tampons_requis": 10, "recompense": "Ein Baguette gratis", "recompenses": [ { "seuil": 10, "libelle": "Ein Baguette gratis" } ], "devise": "EUR", "montant_par_tampon": 10, "points_par_unite": null, "tampons_bienvenue": 1, "conditions_exigees": false, "premium": null, "fuseau": "Europe/Paris", "langue": "fr" } ``` | Feld | Bedeutung | |---|---| | `mode` | `tampons`, `paliers` oder `points` ([die Kartentypen](https://stampywallet.com/de/docs/anleitung/kartentypen/)) | | `recompenses` | Jede Prämie mit ihrer Schwelle `seuil` | | `montant_par_tampon` | Die Regel „10 € = 1 Stempel“, oder `null` | | `points_par_unite` | Im Punktemodus: wie viele Punkte es für 1 Währungseinheit gibt | | `conditions_exigees` | `true`, wenn das Geschäft die Zustimmung zu seinen Bedingungen verlangt: Übergeben Sie dann `conditions_acceptees: true`, wenn Sie einen Kunden anlegen | | `premium` | Der zweite Zähler, wenn das Geschäft ihn aktiviert hat, sonst `null` | Source : https://stampywallet.com/de/docs/api/geschaeft/ --- # Kunden anlegen POST /v1/clients meldet einen Kunden im Treueprogramm an und liefert den Link zu seiner Karte, den Sie ihm per SMS oder E-Mail schicken. `POST /v1/clients` Meldet einen Kunden an, als hätte er den Aufsteller gescannt, und liefert das Kundenobjekt mit `lien_carte`: die Seite, auf der er seine Karte zu Apple Wallet oder Google Wallet hinzufügt. Die Willkommensstempel des Geschäfts werden vergeben, wie bei der Anmeldung. **Body (JSON)** - `prenom` (string, optional) : Vorname des Kunden, auf seiner Karte angezeigt. - `nom` (string, optional) : Nachname. - `telephone` (string, optional) : Eine Mobilnummer, im Format des Landes des Geschäfts oder international (`+33612345678`). Sonst `400 telephone_invalide`. - `email` (string, optional) : E-Mail-Adresse. - `conditions_acceptees` (boolean, optional) : Pflicht (`true`), wenn das Geschäft die Zustimmung zu seinen Bedingungen verlangt (`conditions_exigees` aus [`GET /v1/commerce`](https://stampywallet.com/de/docs/api/geschaeft/)); sonst `422 conditions_requises`. > **Achtung :** diese Route **prüft nicht auf Dubletten**: Zweimal aufgerufen, legt sie zwei Kunden an. Suchen Sie zuerst mit [`GET /v1/clients`](https://stampywallet.com/de/docs/api/kunden-finden/), oder gehen Sie direkt über [`POST /v1/passages`](https://stampywallet.com/de/docs/api/besuch-erfassen/) mit `creer_si_absent: true`, das den Kunden nur anlegt, wenn es ihn noch nicht gibt. Ein über die API angelegter Kunde wird nie für Angebots-SMS angemeldet: Er wurde darüber nicht informiert. ## Beispiel ```bash title="curl" curl https://app.stampywallet.com/v1/clients \ -H "Authorization: Bearer sw_live_votre_cle" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: inscription-0412" \ -d '{"prenom": "Léa", "telephone": "+33612345678"}' ``` ```js title="Node.js" const r = await fetch('https://app.stampywallet.com/v1/clients', { method: 'POST', headers: { Authorization: `Bearer ${process.env.STAMPY_CLE}`, 'Content-Type': 'application/json', 'Idempotency-Key': 'inscription-0412', }, body: JSON.stringify({ prenom: 'Léa', telephone: '+33612345678' }), }); const client = await r.json(); console.log(client.lien_carte); ``` ```python title="Python" import os, requests r = requests.post( "https://app.stampywallet.com/v1/clients", headers={"Authorization": f"Bearer {os.environ['STAMPY_CLE']}", "Idempotency-Key": "inscription-0412"}, json={"prenom": "Léa", "telephone": "+33612345678"}, ) lien = r.json()["lien_carte"] ``` ## Antwort `201 Created` und [das Kundenobjekt](https://stampywallet.com/de/docs/api/kunden-abrufen/#objet), zum Beispiel: ```json title="201 Created" { "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7", "prenom": "Léa", "nom": null, "telephone": "+33612345678", "email": null, "carte": "X7k2pQ9mLw", "lien_carte": "https://stampywallet.com/c/X7k2pQ9mLw", "cree_le": "2026-10-25T10:41:52.120Z", "etat": { "mode": "tampons", "tampons": 1, "points": null, "objectif": 10, "restants": 9, "prochaine_recompense": { "seuil": 10, "libelle": "Ein Baguette gratis" }, "recompenses_disponibles": [], "recompenses_obtenues": 0, "dernier_passage": null, "premium": null } } ``` > **Hinweis :** schicken Sie `lien_carte` über einen Kanal Ihrer Wahl an den Kunden: StampyWallet schreibt ihm in diesem Schritt nicht. Source : https://stampywallet.com/de/docs/api/kunden-anlegen/ --- # Kunden finden GET /v1/clients findet einen Kunden über seine Telefonnummer, seine E-Mail-Adresse oder den Code seiner Karte. `GET /v1/clients` Findet einen Kunden des Geschäfts. Geben Sie **nur einen** der drei Abfrageparameter an (sonst `400 recherche_requise`): **Abfrageparameter** - `telephone` (string, optional) : Die Nummer, in der Adresse kodiert (`%2B33612345678`). Sie wird im Land des Geschäfts gelesen: `0612345678` und `+33612345678` werden beide gefunden. - `email` (string, optional) : E-Mail-Adresse, ohne Beachtung der Groß- und Kleinschreibung. - `carte` (string, optional) : Der Code der Karte, der in ihrem QR-Code steckt. ## Beispiel ```bash title="curl" curl "https://app.stampywallet.com/v1/clients?telephone=%2B33612345678" \ -H "Authorization: Bearer sw_live_votre_cle" ``` ## Antwort ```json title="200 OK" { "clients": [ { "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7", "prenom": "Léa", "nom": "Martin", "telephone": "+33612345678", "email": null, "carte": "X7k2pQ9mLw", "lien_carte": "https://stampywallet.com/c/X7k2pQ9mLw", "cree_le": "2026-10-25T10:41:52.120Z", "etat": { "mode": "tampons", "tampons": 7, "points": null, "objectif": 10, "restants": 3, "prochaine_recompense": { "seuil": 10, "libelle": "Ein Baguette gratis" }, "recompenses_disponibles": [], "recompenses_obtenues": 1, "dernier_passage": "2026-10-28T08:02:11.000Z", "premium": null } } ] } ``` Die Liste ist leer (`"clients": []`), wenn niemand passt: Das ist kein Fehler. Haben mehrere Einträge dieselbe E-Mail-Adresse oder dieselbe Nummer, wird der Kunde mit dem jüngsten Besuch zurückgegeben. Alle Felder im Detail: [das Kundenobjekt](https://stampywallet.com/de/docs/api/kunden-abrufen/#objet). Source : https://stampywallet.com/de/docs/api/kunden-finden/ --- # Kunden abrufen GET /v1/clients/:id liefert einen Kunden und den Stand seiner Stempelkarte, Stempel, Punkte und einzulösende Prämien. `GET /v1/clients/:id` Liefert einen Kunden und den Stand seiner Karte. `:id` ist die UUID, die [`POST /v1/clients`](https://stampywallet.com/de/docs/api/kunden-anlegen/) oder [`GET /v1/clients`](https://stampywallet.com/de/docs/api/kunden-finden/) zurückgibt. Eine unbekannte ID antwortet mit `404 client_introuvable`. ```bash title="curl" curl https://app.stampywallet.com/v1/clients/c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7 \ -H "Authorization: Bearer sw_live_votre_cle" ``` ## Das Kundenobjekt Dasselbe Objekt kommt in allen Kundenrouten zurück und im Feld `client` der anderen Antworten: ```json title="200 OK" { "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7", "prenom": "Léa", "nom": "Martin", "telephone": "0612345678", "email": "lea@exemple.fr", "carte": "X7k2pQ9mLw", "lien_carte": "https://stampywallet.com/c/X7k2pQ9mLw", "cree_le": "2026-10-22T09:14:03.120Z", "etat": { "mode": "tampons", "tampons": 3, "points": null, "objectif": 10, "restants": 7, "prochaine_recompense": { "seuil": 10, "libelle": "Ein Kaffee gratis" }, "recompenses_disponibles": [ { "id": "504c8734-3bbd-4fe9-95f8-7a67c8239dab", "libelle": "Ein Kaffee gratis", "seuil": 10, "piste": "normal", "obtenue_le": "2026-10-20T16:03:44.000Z", "expire_le": null } ], "recompenses_obtenues": 1, "dernier_passage": "2026-10-22T09:20:00.000Z", "premium": null } } ``` | Feld | Bedeutung | |---|---| | `carte` | Der Code der Karte, der in ihrem QR-Code steckt | | `lien_carte` | Die Seite der Karte, die das Hinzufügen zu Apple Wallet oder Google Wallet anbietet | | `etat.tampons`, `etat.points` | `tampons` in den Modi Stempel und Stufen, `points` im Punktemodus; der andere Wert ist `null` | | `etat.restants` | Was bis zur nächsten Prämie noch fehlt | | `etat.recompenses_disponibles` | Die verdienten, noch nicht eingelösten Prämien: Mit ihrer `id` können Sie [sie einlösen](https://stampywallet.com/de/docs/api/praemie-einloesen/) | | `etat.premium` | `{ nom, tampons, objectif, restants }`, wenn das Geschäft den zweiten Zähler aktiviert hat, sonst `null` | > **Hinweis :** IDs sind UUIDs. Die Präfixe `cli_`, `pas_` oder `rec_` vor einer UUID werden bei der Eingabe akzeptiert und ignoriert. Source : https://stampywallet.com/de/docs/api/kunden-abrufen/ --- # Besuch erfassen POST /v1/passages fügt der Karte eines Kunden aus Ihrer Kasse einen Stempel oder Punkte hinzu und meldet, ob eine Prämie erreicht ist. `POST /v1/passages` Das Gegenstück zu einem Scan an der Theke, gesendet von Ihrer Kasse: ein Stempel (oder mehrere) oder Punkte. Es gelten dieselben Regeln und Grenzen wie an der Theke, die Karte des Kunden aktualisiert sich in seinem Wallet, und der Besuch zählt wie jeder andere (Stammkunden, Erinnerungen, Bitte um Bewertung). **Body (JSON)** - `client` (object, erforderlich) : Wer den Besuch erhält: **eines** von `id`, `carte` (der Code der Karte), `email` oder `telephone`. - `montant` (number, optional) : Betrag des Bons, in Einheiten (`12.5` für 12,50 €). Hat das Geschäft eine Regel „10 € = 1 Stempel“, hat der Betrag Vorrang vor `quantite`; im Punktemodus wird er mit der Regel „Punkte pro Euro“ des Geschäfts umgerechnet. - `quantite` (integer, optional) : Modi Stempel und Stufen: Anzahl der Stempel, standardmäßig 1, höchstens 50. - `points` (integer, optional) : Punktemodus ohne Betrag: die zu vergebenden Punkte. Standardmäßig der Wert des Geschäfts. - `reference` (string, optional) : Die Bonnummer. Eine Referenz stempelt pro Geschäft nur einmal. - `creer_si_absent` (boolean, optional) : `true`: Ein unbekannter Kunde, angegeben über `email` oder `telephone`, wird angelegt (mit `prenom` und `nom`, wenn sie in `client` stehen). Standardmäßig `false`. - `conditions_acceptees` (boolean, optional) : Wenn das Geschäft die Zustimmung zu seinen Bedingungen verlangt und `creer_si_absent` den Kunden anlegt (in `client` oder auf oberster Ebene). ## Beispiel ```bash title="curl" curl https://app.stampywallet.com/v1/passages \ -H "Authorization: Bearer sw_live_votre_cle" \ -H "Content-Type: application/json" \ -d '{ "client": { "telephone": "+33612345678", "prenom": "Léa" }, "montant": 12.5, "reference": "TICKET-4512", "creer_si_absent": true }' ``` ```js title="Node.js" const r = await fetch('https://app.stampywallet.com/v1/passages', { method: 'POST', headers: { Authorization: `Bearer ${process.env.STAMPY_CLE}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ client: { telephone: '+33612345678', prenom: 'Léa' }, montant: 12.5, reference: 'TICKET-4512', creer_si_absent: true, }), }); const resultat = await r.json(); if (resultat.recompense_atteinte) console.log('Prämie fällig!'); ``` ```python title="Python" import os, requests r = requests.post( "https://app.stampywallet.com/v1/passages", headers={"Authorization": f"Bearer {os.environ['STAMPY_CLE']}"}, json={"client": {"telephone": "+33612345678", "prenom": "Léa"}, "montant": 12.5, "reference": "TICKET-4512", "creer_si_absent": True}, ) print(r.json()["recompense_atteinte"]) ``` ## Antwort ```json title="201 Created" { "passage": { "id": "226fdea1-ba59-49fb-93e6-60a14a765134", "client_id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7", "valeur": 1, "montant": 12.5, "reference": "TICKET-4512", "cree_le": "2026-10-22T09:20:00.000Z" }, "rejoue": false, "client_cree": false, "recompense_atteinte": true, "recompenses_gagnees": 1, "plafonne": false, "client": { "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7", "prenom": "Léa", "etat": { "tampons": 0, "objectif": 10 } } } ``` | Feld | Bedeutung | |---|---| | `passage.valeur` | Die vergebenen Stempel oder Punkte | | `passage.montant` | Der gespeicherte Betrag, oder `null` | | `rejoue` | `true`, wenn die `reference` schon verwendet wurde: Die Antwort ist dann `200` und liefert den ursprünglichen Besuch, ohne ein zweites Mal zu stempeln | | `client_cree` | `true`, wenn `creer_si_absent` den Kunden angelegt hat | | `recompense_atteinte`, `recompenses_gagnees` | Dieser Besuch bringt eine Prämie (oder mehrere): [einzulösen](https://stampywallet.com/de/docs/api/praemie-einloesen/), wenn der Kunde sie abholt | | `plafonne` | `true`, wenn der Wert auf die Obergrenze der Theke gekürzt wurde | | `client` | [Das Kundenobjekt](https://stampywallet.com/de/docs/api/kunden-abrufen/#objet) nach dem Besuch | ## Ablehnungen | Status | `code` | Wann | |---|---|---| | `404` | `client_introuvable` | Kein passender Kunde, und `creer_si_absent` steht nicht auf `true` | | `409` | `trop_tot` | Ein Besuch desselben Kunden liegt kürzer zurück als die Sperrfrist gegen Doppelbesuche des Geschäfts (standardmäßig 90 Sekunden) | | `422` | `montant_insuffisant` | Der Betrag reicht nicht für einen Stempel (oder einen Punkt) | | `422` | `conditions_requises` | Der Kunde würde angelegt, aber die Bedingungen des Geschäfts sind nicht akzeptiert | > **Achtung :** geben Sie immer eine `reference` an (die Bonnummer): So vergibt eine Kasse, die es nach einem Verbindungsabbruch erneut versucht, keine zwei Stempel. Eine Referenz, deren Besuch storniert wurde, wird nicht erneut vergeben. Source : https://stampywallet.com/de/docs/api/besuch-erfassen/ --- # Besuch stornieren DELETE /v1/passages/:id entfernt den letzten Besuch eines Kunden, zum Beispiel nach einem stornierten oder erstatteten Bon an der Kasse. `DELETE /v1/passages/:id` Entfernt einen Besuch, mit den Rechten eines Managers: Die damit vergebenen Stempel oder Punkte werden abgezogen, und eine Prämie, die er freigeschaltet hatte, verschwindet mit ihm. `:id` ist die UUID, die [`POST /v1/passages`](https://stampywallet.com/de/docs/api/besuch-erfassen/) zurückgibt. Optionaler Body: `{ "motif": "Bon storniert" }` (oder `?motif=` in der Adresse). Standardmäßig lautet der Grund „API“. ## Beispiel ```bash title="curl" curl -X DELETE https://app.stampywallet.com/v1/passages/226fdea1-ba59-49fb-93e6-60a14a765134 \ -H "Authorization: Bearer sw_live_votre_cle" \ -H "Content-Type: application/json" \ -d '{"motif": "Bon erstattet"}' ``` ## Antwort ```json title="200 OK" { "annule": true, "recompenses_retirees": 1, "client": { "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7", "prenom": "Léa", "etat": { "tampons": 9, "objectif": 10 } } } ``` ## Ablehnungen Wie an der Theke lässt sich nur der **letzte** Besuch eines Kunden stornieren, und nie zweimal. | Status | `code` | Wann | |---|---|---| | `404` | `passage_introuvable` | Der Besuch existiert in diesem Geschäft nicht | | `409` | `pas_dernier` | Es ist nicht der letzte Besuch des Kunden | | `409` | `deja_annule` | Der Besuch ist bereits storniert | | `409` | `recompense_offerte` | Die durch diesen Besuch freigeschaltete Prämie wurde bereits eingelöst (die Antwort enthält ein Feld `recompense`) | Source : https://stampywallet.com/de/docs/api/besuch-stornieren/ --- # Prämie einlösen POST /v1/recompenses markiert eine verdiente Prämie eines Kunden als eingelöst, direkt aus Ihrer Kasse. `POST /v1/recompenses` Markiert eine verdiente Prämie als an den Kunden übergeben, das Gegenstück zur Schaltfläche „Eingelöst“ im Scanner. Die Karte des Kunden aktualisiert sich in seinem Wallet. **Body (JSON)** - `client` (object, erforderlich) : Der Kunde: **eines** von `id`, `carte`, `email` oder `telephone`. - `recompense_id` (string, optional) : Die UUID der einzulösenden Prämie (in `etat.recompenses_disponibles` des [Kundenobjekts](https://stampywallet.com/de/docs/api/kunden-abrufen/#objet)). Standardmäßig: die älteste fällige. - `piste` (string, optional) : `normal` oder `premium` (der zweite Zähler): ohne `recompense_id` die älteste fällige Prämie dieser Spur. ## Beispiel ```bash title="curl" curl https://app.stampywallet.com/v1/recompenses \ -H "Authorization: Bearer sw_live_votre_cle" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: recompense-ticket-0057" \ -d '{"client": {"carte": "X7k2pQ9mLw"}}' ``` ## Antwort ```json title="200 OK" { "recompense": { "id": "504c8734-3bbd-4fe9-95f8-7a67c8239dab", "libelle": "Ein Kaffee gratis", "piste": "normal", "offerte_le": "2026-10-22T09:25:00.000Z" }, "client": { "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7", "prenom": "Léa", "etat": { "recompenses_disponibles": [] } } } ``` Gibt es keine Prämie einzulösen, lautet die Antwort `409` mit dem Code `aucune_recompense`. Source : https://stampywallet.com/de/docs/api/praemie-einloesen/ --- # Webhooks Erhalten Sie bei jedem Besuch, jeder Prämie oder neuen Karte einen signierten HTTP-Aufruf auf Ihrem Server, in Zapier, Make oder n8n, und prüfen Sie seine HMAC-Signatur. Ein Webhook ist eine Adresse auf Ihrem Server, die StampyWallet bei jedem Ereignis an der Theke aufruft: ein Besuch, eine Prämie, eine neue Karte, ein verkaufter Gutschein. So verbinden Sie StampyWallet mit einer Kasse, einem CRM, einer Tabelle oder einem No-Code-Tool, ohne offizielle Integration. > **In die andere Richtung? :** damit Ihre Kasse bei jedem Verkauf einen Stempel vergibt, nutzen Sie [`POST /v1/passages`](https://stampywallet.com/de/docs/api/besuch-erfassen/), oder [empfangen Sie die Verkäufe Ihrer Kasse](https://stampywallet.com/de/docs/api/kassen-eingang/) direkt. ## Eine Adresse einrichten Unter **Einstellungen › Integrationen › Webhooks** (Inhaber und Manager): 1. **Fügen Sie eine öffentliche `https://`-Adresse hinzu** und haken Sie bei Bedarf die gewünschten Ereignisse an. **Kein Haken gesetzt: alle Ereignisse**, auch die, die später dazukommen. 2. **Kopieren Sie das Signatur-Secret**, das mit `whsec_` beginnt. Es wird nur einmal angezeigt; danach zeigt der Bildschirm nur noch die letzten vier Zeichen. 3. **Klicken Sie auf „Test senden“**: Ein Beispiel-`passage.cree`, markiert mit `"test": true`, geht sofort an Ihre Adresse, und der Bildschirm zeigt die erhaltene Antwort. Der Bildschirm zeigt die letzten 20 Zustellungen (Status, Code, Dauer, Versuch) und eine Schaltfläche **Erneut senden** bei den fehlgeschlagenen. Höchstens zehn Adressen pro Geschäft; jede lässt sich deaktivieren, wieder aktivieren oder löschen. > **Achtung :** abgelehnt werden: eine Adresse, die nicht mit `https://` beginnt, eine Adresse mit Zugangsdaten (`https://ich:geheim@…`) und jede private oder lokale Adresse (`localhost`, `10.x`, `192.168.x`…), auch wenn sie erst über DNS aufgelöst wird. Alle Ports sind erlaubt. Weiterleitungen werden nie verfolgt: Eine 3xx-Antwort zählt als Fehlschlag. ## Was Ihr Server empfängt Eine `POST`-Anfrage in JSON, mit diesen Headern: ```http title="Header" POST /votre/adresse HTTP/1.1 Content-Type: application/json User-Agent: StampyWallet-Webhooks/1.0 StampyWallet-Evenement: passage.cree StampyWallet-Id: evt_WdGHduXPRbExh0vh5eYtCjXo StampyWallet-Signature: t=1792648365,v1=8f3c…(64 Hexadezimalzeichen) ``` Und diesen Body. Die Hülle ist für alle Ereignisse gleich; nur `donnees` ändert sich ([die Liste der Ereignisse](https://stampywallet.com/de/docs/api/ereignisse/)): ```json title="passage.cree" { "id": "evt_WdGHduXPRbExh0vh5eYtCjXo", "type": "passage.cree", "cree_le": "2026-10-22T05:52:45.694Z", "commerce": { "id": "9f1cbdfc-df71-4fab-a554-3bdbb7c71ebf", "nom": "Le Café des Crochets" }, "donnees": { "client": { "id": "40de4b86-1d7a-4cc6-add3-b7a83fa43c04", "prenom": "Inès", "telephone": "+33611223344", "email": "ines@example.com" }, "passage": { "id": "226fdea1-ba59-49fb-93e6-60a14a765134", "quantite": 1, "montant": null, "devise": "EUR", "reference": "caisse-1", "source": "scan", "piste": "normal", "tampons": 1, "objectif": 2 } } } ``` - `id`: `evt_` gefolgt von 24 Zeichen. **Bei allen Zustellungen eines Ereignisses gleich** (Versuche, erneutes Senden, und von einer Adresse zur anderen): Das ist Ihr Schlüssel zum Entfernen von Dubletten. - `cree_le`: der Zeitpunkt des Ereignisses (nicht der Zustellung), in ISO 8601 UTC. - `test`: nur vorhanden, mit `true`, bei der Zustellung über die Schaltfläche „Test senden“. - `donnees.client`: `{ id, prenom }`, dazu `telephone` und `email` nur, wenn der Kunde sie angegeben hat; `null` bei einem Gutschein oder einem Prepaid-Paket. - Beträge (`montant`, `prix`) sind in **Cent** angegeben, als Ganzzahlen, mit ihrer `devise` (ISO 4217). - Neue Schlüssel können hinzukommen: Ignorieren Sie, was Sie nicht kennen. ## Die Signatur prüfen Prüfen Sie jede Anfrage, **bevor** Sie ihrem Inhalt vertrauen: Sonst könnte jeder Ihre Adresse aufrufen. ```text title="Die Berechnung" StampyWallet-Signature: t=,v1= Signatur = hex( HMAC-SHA256( Schlüssel = Secret, Nachricht = "." ) ) ``` - Der Schlüssel ist das **vollständige** Secret, einschließlich des Präfixes `whsec_`. - Die Nachricht ist der Zeitstempel `t`, ein Punkt, dann der Body **so, wie er angekommen ist**, als Bytes. Parsen Sie das JSON nicht vor der Prüfung neu: Ein neu geschriebenes JSON hat nicht mehr dieselben Bytes. - Lehnen Sie ein `t` ab, das mehr als 5 Minuten von Ihrer Uhr abweicht: Das verhindert, dass eine alte Anfrage erneut abgespielt wird. - Der Header kann mehrere `v1=` enthalten (am Tag eines Secret-Wechsels): Es genügt, wenn eines übereinstimmt. Vergleichen Sie in konstanter Zeit. ```js title="Node.js" const crypto = require('node:crypto'); /** corpsBrut: der empfangene Body, als Buffer (oder Text), VOR jedem JSON.parse. */ function verifierStampyWallet(secret, corpsBrut, entete, tolerance = 300) { let t = null; const v1 = []; for (const morceau of String(entete || '').split(',')) { const i = morceau.indexOf('='); const cle = morceau.slice(0, i).trim(); const valeur = morceau.slice(i + 1).trim(); if (cle === 't' && /^\d+$/.test(valeur)) t = Number(valeur); if (cle === 'v1') v1.push(valeur); } if (t === null || v1.length === 0) return false; if (Math.abs(Math.floor(Date.now() / 1000) - t) > tolerance) return false; const attendue = crypto.createHmac('sha256', secret) .update(`${t}.`).update(corpsBrut).digest('hex'); return v1.some((s) => s.length === attendue.length && crypto.timingSafeEqual(Buffer.from(s), Buffer.from(attendue))); } // Mit Express: auf dieser Route den Roh-Body behalten. app.post('/stampywallet', express.raw({ type: 'application/json' }), (req, res) => { const ok = verifierStampyWallet(process.env.STAMPYWALLET_WEBHOOK_SECRET, req.body, req.get('StampyWallet-Signature')); if (!ok) return res.status(400).end(); const evenement = JSON.parse(req.body.toString('utf8')); // Dubletten über evenement.id entfernen, dann später verarbeiten res.status(200).end(); }); ``` ```python title="Python" import hashlib import hmac import time def verifier_stampywallet(secret: str, corps_brut: bytes, entete: str, tolerance: float = 300) -> bool: """corps_brut: die empfangenen Bytes (Flask: request.get_data()), vor jedem json.loads.""" t, v1 = None, [] for morceau in (entete or "").split(","): cle, _, valeur = morceau.strip().partition("=") if cle == "t" and valeur.isdigit(): t = int(valeur) elif cle == "v1": v1.append(valeur) if t is None or not v1: return False if abs(int(time.time()) - t) > tolerance: return False attendue = hmac.new(secret.encode(), f"{t}.".encode() + corps_brut, hashlib.sha256).hexdigest() return any(hmac.compare_digest(s, attendue) for s in v1) # Mit Flask: # @app.post("/stampywallet") # def recevoir(): # if not verifier_stampywallet(os.environ["STAMPYWALLET_WEBHOOK_SECRET"], # request.get_data(), # request.headers.get("StampyWallet-Signature", "")): # abort(400) # evenement = request.get_json() # return "", 200 ``` ```php title="PHP" $tolerance) { return false; } $attendue = hash_hmac('sha256', $t . '.' . $corpsBrut, $secret); foreach ($v1 as $s) { if (hash_equals($attendue, $s)) { return true; } } return false; } // der Roh-Body, vor json_decode $corps = file_get_contents('php://input'); $ok = verifier_stampywallet(getenv('STAMPYWALLET_WEBHOOK_SECRET'), $corps, $_SERVER['HTTP_STAMPYWALLET_SIGNATURE'] ?? ''); ``` ### Testvektor Zum Prüfen Ihres Codes: Mit diesen Werten und einer unendlichen Toleranz (`Infinity`, `float("inf")`, `PHP_INT_MAX`) muss die Funktion wahr zurückgeben. Der Body steht in einer einzigen Zeile, ohne abschließenden Zeilenumbruch, und enthält absichtlich ein „é“: Die Signatur bezieht sich auf die UTF-8-Bytes. ```text title="Vektor" secret : whsec_5WZbPq8rLk2N7xYdTf3Hc9JmVg4RsQe1 t : 1761134400 corps : {"id":"evt_4fK9mQ2xT7bL1nR8vZ3cW6yH","type":"passage.cree","cree_le":"2026-10-22T12:00:00.000Z","commerce":{"id":"9b2f6c1e-4d3a-4f7b-8e21-5a6c7d8e9f01","nom":"Le Café du Coin"},"donnees":{"client":{"id":"3c1d2e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f","prenom":"Camille"},"passage":{"id":"7e8f9a0b-1c2d-4e3f-9a4b-5c6d7e8f9a0b","quantite":1,"montant":null,"devise":"EUR","reference":null,"source":"scan","piste":"normal","tampons":4,"objectif":10}}} v1 : 4346dff69a3e9e25937b22ec031a8eaf8cfce3baca4dfb932865682b8f891f1d en-tête: t=1761134400,v1=4346dff69a3e9e25937b22ec031a8eaf8cfce3baca4dfb932865682b8f891f1d ``` ## Antworten und Wiederholungen - Antworten Sie mit einem **2xx-Code in weniger als 10 Sekunden**. Der Body Ihrer Antwort wird ignoriert. Antworten Sie schnell und erledigen Sie lange Arbeiten danach. - Andernfalls gibt es insgesamt **acht Versuche**: den ersten sofort, dann nach 1 Min., 5 Min., 30 Min., 2 Std., 5 Std., 8 Std. und 8 Std. Der letzte geht etwa 23,5 Stunden nach dem ersten raus; nach dem achten Fehlschlag wird die Zustellung aufgegeben. - Nach **50 Fehlschlägen in Folge** wird eine Adresse **deaktiviert**, und der Inhaber des Geschäfts erhält eine E-Mail. Aktivieren Sie sie wieder, sobald Ihr Server repariert ist: Ihr Zähler beginnt dann bei null. - Die Testzustellung wird nur einmal versucht und zählt nicht zu den Fehlschlägen. - **Erneut senden** schickt dasselbe Ereignis noch einmal (dieselbe `id`, dieselben Bytes), mit einer neuen Signatur. - **Mindestens einmal, ohne garantierte Reihenfolge**: Ein Ereignis kann zweimal ankommen, entfernen Sie Dubletten über `StampyWallet-Id`; zwei kurz aufeinanderfolgende Ereignisse können in falscher Reihenfolge ankommen, verlassen Sie sich auf `cree_le`. - Zustellungen bleiben 30 Tage im Protokoll. | Status einer Zustellung | Bedeutung | |---|---| | `en_attente` | Noch nicht versucht | | `echec` | Der letzte Versuch ist fehlgeschlagen; ein weiterer ist geplant | | `livre` | Ein 2xx wurde empfangen | | `abandonne` | Acht Fehlschläge, oder Adresse deaktiviert, oder durch erneutes Senden ersetzt | > **Ohne Code :** Zapier, Make und n8n empfangen diese Webhooks so, wie sie sind: Tragen Sie die Adresse ihres „Webhook“-Auslösers als Adresse ein. Die Schritt-für-Schritt-Anleitungen finden Sie unter [Kasse anbinden](https://stampywallet.com/de/docs/api/kasse-anbinden/#sans-code). Source : https://stampywallet.com/de/docs/api/webhooks/ --- # Liste der Ereignisse Die neun Ereignisse, die die Webhooks von StampyWallet senden, wann sie ausgelöst werden und der genaue Inhalt ihres Felds donnees. Jedes Ereignis hat dieselbe Hülle (`id`, `type`, `cree_le`, `commerce`, siehe [Webhooks](https://stampywallet.com/de/docs/api/webhooks/#requete)). Nur `donnees` ändert sich; unten wird nur dieses Feld gezeigt. Die Ereignisse werden von der Theke genauso ausgelöst wie von der API: Ein Besuch, der gescannt oder über [`POST /v1/passages`](https://stampywallet.com/de/docs/api/besuch-erfassen/) erfasst wird, erzeugt dasselbe `passage.cree`. | Ereignis | Gesendet, wenn | |---|---| | `client.cree` | Ein Kunde tritt dem Programm bei (seine Karte wird erstellt) | | `carte.ajoutee` | Der Kunde speichert seine Karte in Apple Wallet oder Google Wallet | | `passage.cree` | Ein Besuch wird erfasst: ein oder mehrere Stempel, oder Punkte | | `passage.annule` | Der letzte Besuch eines Kunden wird storniert | | `recompense.atteinte` | Ein Besuch überschreitet eine Stufe: Eine Prämie ist fällig (eine pro überschrittener Stufe) | | `recompense.offerte` | Die Prämie wird dem Kunden übergeben | | `recompense.annulee` | Die Übergabe einer Prämie wird storniert: Sie ist wieder fällig | | `carte_cadeau.vendue` | Ein Gutschein wird verkauft | | `forfait.vendu` | Ein Prepaid-Paket wird verkauft | > **Hinweis :** `carte.ajoutee` gilt für Apple Wallet und Google Wallet: `donnees.carte.wallet` ist `apple` oder `google`. Bei Apple wird das Ereignis für jedes neue Gerät ausgelöst (ein iPhone und dann eine Uhr ergeben zwei). Das Entfernen der Karte löst nichts aus. ## client.cree ```json title="donnees" { "client": { "id": "3374a06e-9608-4376-91cb-1a3fb6721b04", "prenom": "Camille", "cree_le": "2026-10-22T05:52:45.664Z" } } ``` `telephone` und `email` erscheinen nur, wenn der Kunde sie angegeben hat. `prenom` kann `null` sein. ## carte.ajoutee ```json title="donnees" { "client": { "id": "40de4b86-1d7a-4cc6-add3-b7a83fa43c04", "prenom": "Inès", "telephone": "+33611223344", "email": "ines@example.com" }, "carte": { "wallet": "apple" } } ``` ## passage.cree ```json title="donnees" { "client": { "id": "40de4b86-1d7a-4cc6-add3-b7a83fa43c04", "prenom": "Inès", "telephone": "+33611223344", "email": "ines@example.com" }, "passage": { "id": "226fdea1-ba59-49fb-93e6-60a14a765134", "quantite": 1, "montant": null, "devise": "EUR", "reference": "caisse-1", "source": "scan", "piste": "normal", "tampons": 1, "objectif": 2 } } ``` - `quantite`: was der Besuch wert ist (Stempel, oder Punkte im Punktemodus). - `montant`: der Betrag des Bons in Cent, falls er eingegeben wurde, sonst `null`. - `reference`: die Vorgangskennung, die der Aufrufer gesendet hat (die Referenz der API oder die der Theke), sonst `null`. - `source`: `scan`, `manuel`, `api`… - `piste`: `normal`, oder `premium` für den zweiten Zähler. - `tampons` (oder `points` im Punktemodus) und `objectif`: der Zählerstand **nach** dem Besuch. Ein Besuch, der die Karte vollmacht, liefert den Stand der nächsten Karte (oft `0`); die Prämie kommt in einem eigenen `recompense.atteinte`. ## passage.annule ```json title="donnees" { "client": { "id": "40de4b86-1d7a-4cc6-add3-b7a83fa43c04", "prenom": "Inès", "telephone": "+33611223344", "email": "ines@example.com" }, "passage": { "id": "d8f62d77-88a6-44ef-a0c3-2a7d5066b90a", "quantite": 1, "source": "scan", "piste": "normal", "tampons": 0, "objectif": 2 }, "recompenses_retirees": 0, "motif": "doppelt gescannt" } ``` `passage.id` ist die des ursprünglichen `passage.cree`, und der Zählerstand der nach der Stornierung. `recompenses_retirees`: die Prämien, die dieser Besuch freigeschaltet hatte und die mit ihm verschwinden. `motif`: der an der Theke eingegebene Grund, oder `null`. ## recompense.atteinte ```json title="donnees" { "client": { "id": "40de4b86-1d7a-4cc6-add3-b7a83fa43c04", "prenom": "Inès", "telephone": "+33611223344", "email": "ines@example.com" }, "recompense": { "id": "504c8734-3bbd-4fe9-95f8-7a67c8239dab", "libelle": "Ein Kaffee gratis", "palier": 2, "piste": "normal", "expire_le": null }, "passage_id": "8bfbdd5e-eff4-4a3b-94fe-1557ec6edce6" } ``` Ein Ereignis pro überschrittener Stufe. `expire_le` ist `null`, wenn die Prämien des Geschäfts nicht verfallen. ## recompense.offerte ```json title="donnees" { "client": { "id": "40de4b86-1d7a-4cc6-add3-b7a83fa43c04", "prenom": "Inès", "telephone": "+33611223344", "email": "ines@example.com" }, "recompense": { "id": "504c8734-3bbd-4fe9-95f8-7a67c8239dab", "libelle": "Ein Kaffee gratis", "piste": "normal", "offerte_le": "2026-10-22T05:54:51.790Z" } } ``` ## recompense.annulee ```json title="donnees" { "client": { "id": "40de4b86-1d7a-4cc6-add3-b7a83fa43c04", "prenom": "Inès", "telephone": "+33611223344", "email": "ines@example.com" }, "recompense": { "id": "504c8734-3bbd-4fe9-95f8-7a67c8239dab", "libelle": "Ein Kaffee gratis", "piste": "normal" }, "motif": "falsche Karte" } ``` ## carte_cadeau.vendue ```json title="donnees" { "client": null, "carte_cadeau": { "id": "ac7e56a5-3c00-492f-971a-21ca7d675fd6", "code": "EJ9Y-7FYN", "sorte": "montant", "produit": null, "montant": 2500, "devise": "EUR", "pour": "Lucie", "de": "Marc", "canal": "comptoir", "expire_le": "2027-04-22T05:54:51.879Z" } } ``` `sorte` ist `montant` oder `produit` (dann enthält `produit` den Namen und `montant` den Preis). Hier 2500 Cent: 25 €. > **Achtung :** `code` ist der Code des Gutscheins, der in seinem QR-Code steckt: Er reicht aus, um ihn an der Theke zu belasten. Behandeln Sie ihn wie ein Geheimnis: Schreiben Sie ihn weder in eine geteilte Tabelle noch in Logs. ## forfait.vendu ```json title="donnees" { "client": null, "forfait": { "id": "0ec29323-ed13-4e6b-9595-963601290eac", "code": "XFF2-WTW9", "nom": "10 Kaffee", "unites": 10, "prix": 3000, "devise": "EUR", "titulaire": "Paul", "canal": "comptoir", "expire_le": "2027-04-22T05:54:51.891Z" } } ``` `titulaire`: der beim Verkauf eingetragene Name, oder `null`. `expire_le` ist `null` bei einem Prepaid-Paket ohne Ablaufdatum. Wie bei einem Gutschein ist `code` geheim zu halten. > **Hinweis :** die personenbezogenen Daten beschränken sich auf das, was der Kunde bei der Anmeldung angegeben hat. Sobald Sie sie erhalten haben, liegen sie in Ihrer Verantwortung: Bewahren Sie sie nur so lange auf wie nötig. Source : https://stampywallet.com/de/docs/api/ereignisse/ --- # Ereignisse Ihrer Kasse empfangen POST /v1/entrants/:jeton empfängt die Verkäufe aus Square, Shopify, SumUp, Zettle oder jedem anderen Tool und schreibt den Besuch dem richtigen Kunden gut. `POST /v1/entrants/:jeton` Eine Adresse, die Sie in Ihrer Kasse hinterlegen: Bei jedem bezahlten Verkauf ruft die Kasse sie auf, und StampyWallet schreibt den Besuch auf die Karte des Kunden, den es über seine E-Mail-Adresse oder Telefonnummer findet. Sie müssen keinen Schlüssel in die Kasse eintragen: Das Token in der Adresse genügt. Eine unbekannte oder widerrufene Adresse antwortet mit `404`. ## Die Quellen Jede Adresse wird für eine Quelle unter **Einstellungen › Integrationen** erstellt, mit einem optionalen Signaturschlüssel. StampyWallet liest dann das Format dieser Kasse so, wie es ankommt: | Quelle | Was zählt | Kunde | Betrag | Referenz | |---|---|---|---|---| | `square` | `payment.created` / `payment.updated` mit Status `COMPLETED` | E-Mail des Käufers, oder E-Mail und Telefon des Kunden | Ohne Trinkgeld | Die ID der Zahlung | | `shopify` | `orders/paid` | E-Mail und Telefon des Kunden oder der Bestellung | Zwischensumme der Bestellung | Die ID der Bestellung | | `sumup` (Beta) | Transaktion `PAID` oder `SUCCESSFUL` | E-Mail oder Telefon | Betrag der Transaktion | Transaktionscode | | `zettle` (Beta) | `PurchaseCreated` | E-Mail oder Telefon des Kunden | Betrag des Kaufs | Die ID des Kaufs | | `generique` | Der Body von [`POST /v1/passages`](https://stampywallet.com/de/docs/api/besuch-erfassen/) | `client` | `montant` | `reference` (optional) | > **Hinweis :** die Kassenquellen **legen nie einen Kunden an**: Ein Verkauf ohne bekannten Kunden wird ignoriert. Ein Verkauf ohne E-Mail und ohne Telefon, oder ohne Referenz, wird ebenfalls ignoriert. Nur die Quelle `generique` kann einen Kunden anlegen, mit `creer_si_absent: true`. ## Die Signatur Ist für die Adresse ein Signaturschlüssel hinterlegt, muss jeder Aufruf signiert sein, sonst `401 signature_invalide`. Fügen Sie ihn immer ein, wenn die Kasse einen bereitstellt. | Quelle | Header | Signatur | |---|---|---| | `generique` | `X-Stampy-Signature` | HMAC-SHA256 hexadezimal über den Roh-Body, mit dem Schlüssel der Adresse (`sha256=` davor wird akzeptiert) | | `square` | `x-square-hmacsha256-signature` | HMAC-SHA256 Base64 über die Benachrichtigungs-URL, gefolgt vom Roh-Body | | `shopify` | `X-Shopify-Hmac-Sha256` | HMAC-SHA256 Base64 über den Roh-Body | | `sumup` | `X-Payload-Signature` | HMAC-SHA256 hexadezimal über den Roh-Body | | `zettle` | `X-iZettle-Signature` | HMAC-SHA256 hexadezimal über `timestamp + "." + payload` | ## Das generische Format Für ein Skript, ein No-Code-Tool oder eine Kasse ohne bekanntes Format senden Sie denselben Body wie bei [`POST /v1/passages`](https://stampywallet.com/de/docs/api/besuch-erfassen/): ```bash title="curl" corps='{"client": {"telephone": "+33612345678"}, "montant": 18.9, "reference": "T-2026-1025-0091"}' signature=$(printf '%s' "$corps" | openssl dgst -sha256 -hmac "$STAMPY_ENTRANT_SECRET" | sed 's/^.* //') curl https://app.stampywallet.com/v1/entrants/9QkT2vX7pL4mR8sN1bC6dF3gH5jK0wYz \ -H "Content-Type: application/json" \ -H "X-Stampy-Signature: $signature" \ -d "$corps" ``` ```js title="Node.js" const crypto = require('node:crypto'); const corps = JSON.stringify({ client: { telephone: '+33612345678' }, montant: 18.9, reference: 'T-2026-1025-0091' }); const signature = crypto.createHmac('sha256', process.env.STAMPY_ENTRANT_SECRET).update(corps).digest('hex'); await fetch(process.env.STAMPY_ENTRANT_URL, { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-Stampy-Signature': signature }, body: corps, }); ``` ## Die Antworten Sobald der Aufruf authentifiziert ist, lautet die Antwort immer `200`, damit die Kasse nichts über Ihren Kundenstamm erfährt: - `{ "ok": true, "ignore": true }`: Das Ereignis betrifft uns nicht (nicht bezahlt, anderes Thema, ohne Kunde, oder bei einer Kasse ohne Referenz); - `{ "ok": true }`: in allen anderen Fällen, ob der Kunde existiert oder nicht, ob der Besuch gutgeschrieben oder abgelehnt wurde (zu früh, Betrag zu klein). Nur eine echte Störung antwortet mit `500`: Die Kasse versucht es erneut, und die Referenz stellt sicher, dass ein neuer Versuch nicht zweimal stempelt. Jede Adresse nimmt 300 Aufrufe pro Minute an. Die Einstellungen Schritt für Schritt, Kasse für Kasse: [Kasse anbinden](https://stampywallet.com/de/docs/api/kasse-anbinden/). Source : https://stampywallet.com/de/docs/api/kassen-eingang/ --- # Kasse anbinden Square, Shopify, SumUp, Zettle, Zapier, Make oder n8n anbinden, damit ein Verkauf einen Stempel vergibt: Shopify und die No-Code-Tools richten Sie selbst ein, die Verbindung mit einem Klick für Square, SumUp und Zettle ist in Vorbereitung. Ihre Kasse anbinden heißt: Sie geben der Kasse eine StampyWallet-Adresse, die sie bei jedem bezahlten Verkauf aufruft. Der Besuch landet dann von selbst auf der Karte des Kunden, den StampyWallet über seine Telefonnummer oder E-Mail-Adresse findet. Zum Start ist nichts davon nötig: Der Scan an der Theke reicht, die Kasse ist ein Plus, vor allem für eine [Punktekarte](https://stampywallet.com/de/docs/anleitung/kartentypen/#points). > **Hinweis :** die Kasse kennt den Kunden nur, wenn sie seine Telefonnummer oder E-Mail-Adresse hat (Kundendatensatz, Bon per E-Mail, Online-Bestellung), und der Kunde muss seine StampyWallet-Karte schon haben: Eine Kasse legt nie einen Kunden an. Ein anonymer Verkauf wird ignoriert: Dafür bleibt der Scan an der Theke der richtige Weg. Sie suchen eher den Überblick als die Einrichtung? Die Seite [Kassenanbindung](https://stampywallet.com/de/funktionen/kassenanbindung/) zeigt, was die Anbindungen leisten, welche Kassen heute funktionieren und was sie kosten. ## Zuerst in StampyWallet 1. **Öffnen Sie Einstellungen › Integrationen** und wählen Sie **Verkäufe einer Kasse empfangen**. 2. **Wählen Sie die Kasse** (Square, Shopify, SumUp, Zettle oder „Andere“ für das generische Format). 3. **Kopieren Sie die erstellte Adresse**, in der Form `https://app.stampywallet.com/v1/entrants/ent_…`. ## Dann in Ihrer Kasse **Square** 1. **Die Verbindung mit einem Klick kommt**: eine Schaltfläche „Square verbinden“ unter Einstellungen › Kasse, ohne etwas zu kopieren. Sie wird nach und nach freigeschaltet, sobald Square unsere App freigibt. 2. Bis dahin läuft die manuelle Einrichtung über das **Square Developer Dashboard** (eine App anlegen, ein Webhook-Abonnement, dessen Signaturschlüssel übernehmen): Das ist Entwicklerarbeit. Schreiben Sie uns über die [Kontaktseite](https://stampywallet.com/de/contact/), wir binden Ihre Kasse gemeinsam mit Ihnen an. 3. Es zählen nur Zahlungen mit dem Status `COMPLETED`. **Shopify** 1. Im Shopify-Adminbereich: **Einstellungen › Benachrichtigungen › Webhooks › Webhook erstellen**. 2. Ereignis: **Bestellungszahlung** (`orders/paid`), Format **JSON**, Adresse: die von StampyWallet. 3. Kopieren Sie das Secret, das unter der Liste der Webhooks steht („Deine Webhooks werden mit … signiert“), und fügen Sie es unter Einstellungen › Integrationen ein. 4. Der Kunde wird über die E-Mail-Adresse oder Telefonnummer der Bestellung gefunden. **SumUp** 1. **Die Verbindung mit einem Klick kommt** (Beta), unter Einstellungen › Kasse. SumUp sendet die Verkäufe des Terminals nicht selbst: StampyWallet liest sie aus Ihrem Verlauf und erkennt nur Verkäufe, die die E-Mail-Adresse oder Telefonnummer des Kunden enthalten. 2. Bis dahin schreiben Sie uns über die [Kontaktseite](https://stampywallet.com/de/contact/): Wir schauen mit Ihnen, was mit Ihrem Konto möglich ist. **Zettle** 1. **Die Verbindung mit einem Klick kommt** (Beta), unter Einstellungen › Kasse: StampyWallet legt das Abonnement für Käufe (`PurchaseCreated`) selbst an und speichert dessen Signaturschlüssel. 2. Bis dahin läuft die manuelle Einrichtung über die API von Zettle: Das ist Entwicklerarbeit. Schreiben Sie uns über die [Kontaktseite](https://stampywallet.com/de/contact/), wir binden Ihre Kasse gemeinsam mit Ihnen an. ## Ohne Code: Zapier, Make, n8n In beide Richtungen: Ein No-Code-Tool kann StampyWallet die Verkäufe einer Kasse **senden**, die es kennt, oder die Ereignisse von StampyWallet **empfangen**, um eine Tabelle, ein CRM oder eine E-Mail-Liste zu füllen. **Zapier** **Einen Verkauf an StampyWallet senden** 1. Auslöser: Ihre Kasse oder Ihr Shop („New Payment“, „New Order“…). 2. Aktion: **Webhooks by Zapier › POST**, URL: die Adresse „Andere“ (generisches Format), Datentyp: JSON. 3. Body: `{"client": {"telephone": "…"}, "montant": …, "reference": "…"}` (oder `email` statt `telephone`), wobei die Referenz die Nummer des Verkaufs ist. **Die Ereignisse von StampyWallet empfangen** 1. Auslöser: **Webhooks by Zapier › Catch Hook**. Kopieren Sie die Adresse des Hooks. 2. Fügen Sie sie als Empfangsadresse unter Einstellungen › Integrationen ein ([Webhooks](https://stampywallet.com/de/docs/api/webhooks/)) und klicken Sie dann auf „Test senden“. **Make** **Einen Verkauf an StampyWallet senden** 1. Das Modul Ihrer Kasse als Auslöser, dann das Modul **HTTP › Make a request**. 2. Methode `POST`, URL: die Adresse „Andere“, JSON-Body `{"client": {"telephone": "…"}, "montant": …, "reference": "…"}`, wie bei [`POST /v1/passages`](https://stampywallet.com/de/docs/api/besuch-erfassen/). **Die Ereignisse von StampyWallet empfangen** 1. Modul **Webhooks › Custom webhook**, kopieren Sie die Adresse. 2. Fügen Sie sie als Empfangsadresse unter Einstellungen › Integrationen ein, dann „Test senden“, damit Make die Struktur lernt. **n8n** **Einen Verkauf an StampyWallet senden** 1. Der Node Ihrer Kasse als Auslöser, dann ein Node **HTTP Request**. 2. Methode `POST`, URL: die Adresse „Andere“, JSON-Body `{"client": {"telephone": "…"}, "montant": …, "reference": "…"}`, wie bei [`POST /v1/passages`](https://stampywallet.com/de/docs/api/besuch-erfassen/). **Die Ereignisse von StampyWallet empfangen** 1. Node **Webhook** (Methode POST), kopieren Sie die Produktionsadresse. 2. Fügen Sie sie als Empfangsadresse unter Einstellungen › Integrationen ein. Um die Signatur zu prüfen, fügen Sie einen Node **Code** mit dem Node.js-Beispiel von der Seite [Webhooks](https://stampywallet.com/de/docs/api/webhooks/#signature) hinzu. ## Eine andere Kasse Wenn Ihre Kasse bei jedem Verkauf eine Adresse aufrufen kann (viele können das, unter dem Namen „Webhook“ oder „Benachrichtigung“), nutzen Sie die Adresse „Andere“ und das [generische Format](https://stampywallet.com/de/docs/api/kassen-eingang/#le-format-generique). Sonst schreiben Sie uns über die [Kontaktseite](https://stampywallet.com/de/contact/): Wir schauen es uns mit Ihnen an. ## Häufige Fragen **Funktioniert das mit meiner Kasse?** Shopify richten Sie heute selbst ein; Square, SumUp und Zettle laufen über die kommende Verbindung mit einem Klick, oder bis dahin über uns. Jede andere Kasse, die bei jedem Verkauf eine Adresse aufrufen kann, nutzt das generische Format, und eine Kasse, die Zapier, Make oder n8n kennen, kann über diese Tools laufen. Sonst schreiben Sie uns: Wir schauen es uns mit Ihnen an. **Brauche ich einen Entwickler?** Nicht für Shopify und nicht für Zapier, Make oder n8n: Sie kopieren eine Adresse, fügen sie ein, fertig. Für Square, SumUp und Zettle braucht die manuelle Einrichtung heute einen Entwickler; die Verbindung mit einem Klick (Einstellungen › Kasse) kommt, und bis dahin richten wir sie mit Ihnen ein: Schreiben Sie uns über die [Kontaktseite](https://stampywallet.com/de/contact/). **Muss mein Kunde seine Karte schon haben?** Ja. Eine Kasse legt nie einen Kunden an: Sie findet die Karte über die Telefonnummer oder E-Mail-Adresse des Kunden. Ein anonymer Verkauf wird ignoriert, und dann bleibt der Scan an der Theke der richtige Weg. **Kann ein Verkauf doppelt zählen?** Nein. Jeder Verkauf hat seine Referenz: Versucht die Kasse es nach einem Verbindungsabbruch erneut, wird der Besuch kein zweites Mal gutgeschrieben. **Ist die Kassenanbindung in meinem Abo enthalten?** Sie gehört zum Tarif Wachstum, für 40 € zzgl. MwSt. pro Monat, und ist während der 30 Tage kostenlosen Testphase freigeschaltet. Im Tarif Essential ist sie nicht enthalten. Source : https://stampywallet.com/de/docs/api/kasse-anbinden/ --- # Den Skill „schöne Karten“ installieren Eine Markdown-Datei, die Ihrem KI-Assistenten beibringt, die Kundenkarten eines Ladens so zu gestalten wie wir: zuerst seine echten Bilder, die vierzehn Kartenformen, Icons, die die Prämie zeigen, und eine Prüfung, bevor etwas gezeigt wird. https://stampywallet.com/de/docs/skill.md ## Schöne Kundenkarten Ziel: Der Ladeninhaber erkennt SEINEN Laden auf den ersten Blick. Eine generische Karte (Sterne, einfarbiger Hintergrund, „Eine Leistung gratis“) macht niemandem Lust; sein Logo, seine Farbe, sein Lieblingsprodukt schon. Dieser Skill stützt sich auf den MCP-Server von StampyWallet (`https://app.stampywallet.com/mcp`), Werkzeug `concevoir_carte`: Es erzeugt ein echtes Bild der Karte für Apple Wallet und Google Wallet, ohne Konto und ohne etwas zu speichern. Ohne diesen Server beschreiben Sie die Karten in Textform und sagen das der Person. Goldene Regel: **Immer von den echten Bildern des Ladens ausgehen.** Eine erfundene Illustration kommt nur als letzte Möglichkeit, und das wird gesagt. ### 1. Den Laden kennenlernen Bevor Sie gestalten, sammeln Sie: - seinen genauen Namen, seine Branche, seine Stadt; - was er in den Vordergrund stellt: Lieblingsprodukt, Atmosphäre, Farben seiner Ladenfront oder seines Logos, Ton seiner Kommunikation; - seine aktuelle Prämie, falls er schon eine Stempelkarte aus Papier hat (sie bleibt in mindestens einer Version erhalten); - die Sprache seiner Kunden (die Karte wird in dieser Sprache geschrieben). Quellen: seine Website, sein Google-Unternehmensprofil, seine öffentlichen Social-Media-Kanäle oder einfach das, was die Person Ihnen sagt. Fragen Sie nach, wenn das Wichtigste fehlt (Name, Branche); für den Rest machen Sie Vorschläge. ### 2. Seine echten Bilder finden In dieser Reihenfolge: 1. **Sein Logo**: auf seiner Website (Kopfzeile, Favicon in groß), sein Profilbild in den sozialen Netzwerken oder eine Datei von der Person. 2. **Seine Produkte**: die Fotos seiner Website oder seiner Beiträge, um jede Prämie zu bebildern (das Croissant, die Behandlung, den Strauß). 3. **Seine Farben**: aus dem Logo oder der Ladenfront. Die Bilder werden `concevoir_carte` über ihre **https**-Adresse übergeben (PNG, JPEG oder WebP, höchstens 5 MB): - `logo_url`: das Logo, oben auf der Karte; ohne angegebene Farbe übernimmt die Karte die Farben des Logos; - `paliers[].image_url`: das Foto einer Prämie (mindestens 64 px Seitenlänge), freigestellt, grau bevor sie verdient ist, danach farbig. Die Bilder eines Ladeninhabers dienen SEINER Karte, die man ihm vorschlägt. Veröffentlichen Sie sie nirgendwo sonst. #### Wenn seine Fotos nicht passen Ein unscharfes Foto, ein Teamfoto für „Kostenlose Lieferung“, ein Detail, das verkleinert nicht mehr zu erkennen ist: Erzwingen Sie nichts. Nehmen Sie ein Icon oder eine Illustration, die die Prämie auf den ersten Blick zeigt (eine Rose für „eine Rose gratis“, ein Lieferwagen für die Lieferung), mit klarer Lizenz: - Icons von **Lucide**, **Phosphor**, **Tabler** (Lizenzen MIT oder ISC), in den Farben des Ladens eingefärbt; - Fotos und Illustrationen von **Unsplash** oder **Pexels**. Notieren Sie die Quelle jedes Bildes. Geben Sie sie nie als Fotos des Ladens aus. Oder nehmen Sie einfach das eingebaute Icon der Stufe (`paliers[].icone`: cafe, croissant, fleur, ciseaux, cadeau…). ### 3. Mindestens 12 Versionen erzeugen, alle Typen gemischt Der Ladeninhaber soll ALLES sehen, was möglich ist, in seinen Farben und mit seinen Bildern, nicht vier Varianten desselben Typs. Eine Version pro Form, vierzehn insgesamt: | Modus (`mode`) | Formen (`forme`) | |---|---| | `tampons`: eine Prämie am Ende | `grille`, `cercles`, `libre`, `objets` | | `paliers`: mehrere Prämien | `chemin`, `vitrine`, `medailles`, `remplissage`, `anneau` | | `points`: je nach Betrag | `remplissage`, `anneau`, `chemin`, `vitrine`, `medailles` | Variieren Sie über die Versionen hinweg außerdem: - die Kollektion (`collection`: `pass`, `cafe`, `botanique`, `original`, `trattoria`, `atelier`), die `palette` oder eine freie `couleur`; - hell und dunkel; - den Stempel (`tampon`: ein Icon der Branche, `rond` für den einfachen); - mit seinem Logo, mit dem Foto seines Produkts als Prämie. Prämien: in SEINEM Wortschatz („10. Stunde gratis“, „ein Strauß der Saison“). Bei Stufen und Punkten realistische Schwellen, als Vorschlag gekennzeichnet; mindestens eine Version behält genau seine aktuelle Prämie, falls er eine hat. Für eine aussagekräftige Vorschau stellen Sie `tampons_poses` ein (eine angefangene Karte). `variantes: true` erzeugt zusätzlich die anderen Paletten einer Kollektion. Eine Form, die für diesen Laden schlecht aussieht (Text zu lang, Überlappung): Korrigieren Sie sie (kürzere Bezeichnung, andere Kollektion), sonst ersetzen Sie sie durch eine Variante in einem anderen Stil, und sagen Sie es. ### 4. Jede Karte in groß prüfen Bevor Sie irgendetwas zeigen, öffnen Sie jedes Bild in groß und prüfen: - der Name ist vollständig und lesbar; - keine Prämie ist abgeschnitten oder überlappt eine andere; - der Text ist auf dem Hintergrund lesbar (Kontrast); - das Logo ist weder unscharf noch beschnitten; - die Fotos der Prämien sind erkennbar, auch in Grau. Machen Sie die fehlerhaften neu. Eine misslungene Karte, die gezeigt wird, schadet mehr, als zwölf gelungene nützen. ### 5. Die Auswahl vorlegen - Eine nummerierte Übersicht, nach Typ geordnet (Stempel, Mehrere Prämien, Punkte), auf einem Telefon lesbar; oder eine Übersicht pro Typ. - Unter jeder Nummer: Modus, Form, Prämie, in einer Zeile. - Sagen Sie immer, dass **sich jedes Bild und jedes Icon ändern lässt**: das Logo, die Fotos der Prämien, der Stempel, die Farben; man kann auch zwei Versionen kombinieren. - Fragen Sie nach der Lieblingsnummer. Schalten Sie nichts ohne seine Wahl live. ### 6. Live schalten Wenn die Person gewählt hat: `creer_commerce` mit genau den Einstellungen der gewählten Version. Rufen Sie es zuerst mit `confirmer: false` auf, zeigen Sie die Zusammenfassung, dann `confirmer: true` nach ihrer Zustimmung. Das Werkzeug liefert einen persönlichen Link: Darüber meldet sich die Person mit ihrer E-Mail an und findet ihre Karte, den QR-Code zum Ausdrucken und ihren kostenlosen Testzeitraum. Hat der Laden schon ein StampyWallet-Konto, das mit dem Assistenten verbunden ist: zuerst `voir_carte`, dann `modifier_carte` (Vorschau, dann Zustimmung), statt `creer_commerce`. ### Was Sie nicht tun - Ein Foto „des Ladens“ erfinden oder eine Illustration als seine ausgeben. - Nur eine Karte zeigen, oder zwölf Varianten desselben Typs. - Eine Karte, die live ist, ohne ausdrückliche Zustimmung ändern. - Stempel oder Prämien versprechen: Sie werden an der Theke vergeben, durch Scannen der Kundenkarte, nie durch einen Assistenten. ## Installation **Claude** 1. **Laden Sie** [skill.md](https://stampywallet.com/de/docs/skill.md) **herunter**. 2. Öffnen Sie in Claude **Einstellungen › Fähigkeiten › Skills** und fügen Sie die Datei hinzu (Claude akzeptiert einen komprimierten Ordner, der `SKILL.md` enthält: Benennen Sie die Datei um, wenn die Oberfläche danach fragt). 3. **Fügen Sie den StampyWallet-Connector hinzu** (`https://app.stampywallet.com/mcp`), damit die Karten wirklich erzeugt werden: [Claude verbinden](https://stampywallet.com/de/docs/mcp/claude/). 4. Fragen Sie: „Gestalte die Kundenkarten von [Name des Ladens, Stadt].“ **ChatGPT** 1. **Kopieren Sie** die Datei (Schaltfläche Kopieren oben). 2. Fügen Sie sie in einem **ChatGPT-Projekt** in die Anweisungen des Projekts ein. 3. **Fügen Sie den StampyWallet-Connector hinzu**: [ChatGPT verbinden](https://stampywallet.com/de/docs/mcp/chatgpt/). 4. In einer Unterhaltung des Projekts: „Gestalte die Kundenkarten von [Name des Ladens].“ **Cursor und Agenten** 1. Geben Sie Ihrem Agenten die direkte Adresse: `https://stampywallet.com/de/docs/skill.md`, oder kopieren Sie die Datei in den Skills- oder Regelordner Ihres Agenten (zum Beispiel `.claude/skills/belles-cartes/SKILL.md` für Claude Code). 2. Fügen Sie den MCP-Server `https://app.stampywallet.com/mcp` zu seiner Konfiguration hinzu: [Cursor und Agenten](https://stampywallet.com/de/docs/mcp/cursor/). 3. Fragen Sie: „Lies den Skill und gestalte dann die Kundenkarten dieses Ladens.“ ## Was die Datei enthält ```markdown title="skill.md" --- name: schoene-kundenkarten description: Mindestens 12 Versionen der Kundenkarte eines Ladens gestalten, mit seinen echten Bildern, über den MCP von StampyWallet, eine nach der anderen geprüft. --- # Schöne Kundenkarten ## 1. Den Laden kennenlernen ## 2. Seine echten Bilder finden ## 3. Mindestens 12 Versionen erzeugen, alle Typen gemischt ## 4. Jede Karte in groß prüfen ## 5. Die Auswahl vorlegen ## 6. Live schalten ``` Die Methode, Schritt für Schritt: [Was der Skill macht](https://stampywallet.com/de/docs/skill/methode/). ## Häufige Fragen **Brauche ich ein StampyWallet-Konto?** Nein. Der Skill und das Werkzeug `concevoir_carte` funktionieren ohne Konto. Das Konto braucht es nur, um die Karte live zu schalten, und das Werkzeug `creer_commerce` legt es für Sie an. **Funktioniert der Skill ohne den MCP-Server?** Er leitet den Assistenten an, aber ohne den MCP-Server kann dieser keine echten Kartenbilder erzeugen: Er beschreibt sie nur. **Kann ich ihn ändern?** Ja, es ist eine einfache Markdown-Datei. Behalten Sie die Regel der echten Bilder und die Prüfung bei: Genau sie machen den Unterschied. **Werden die Bilder des Ladens gespeichert?** Nein. `concevoir_carte` zeigt sie in der Vorschau, ohne etwas zu speichern. Sie kommen erst auf die Karte, wenn der Ladeninhaber sie live schaltet. Source : https://stampywallet.com/de/docs/skill/ --- # Was der Skill macht Die vierzehn Kartenformen, zuerst die echten Bilder, lizenzierte Icons, wenn die Fotos nicht passen, und die Prüfung jeder Karte, bevor sie gezeigt wird. ## Die vierzehn Formen Der Skill verlangt mindestens zwölf Versionen, eine pro Form der Karten-Engine, damit der Ladeninhaber alles Mögliche sieht, bevor er wählt: | Modus | Formen | Wofür | |---|---|---| | Stempel | Raster, Kreise, frei, Objekte | Eine Prämie nach N Besuchen | | Mehrere Prämien | Weg, Vitrine, Medaillen, Füllen, Ring | Immer schönere Prämien | | Punkte | Füllen, Ring, Weg, Vitrine, Medaillen | Punkte je nach Ausgaben des Kunden | Jede Form wird mit [`concevoir_carte`](https://stampywallet.com/de/docs/mcp/werkzeuge/concevoir_carte/) erzeugt, Parameter `mode` und `forme`. Die Modi im Detail: [Die Kartentypen](https://stampywallet.com/de/docs/anleitung/kartentypen/). ## Zuerst die echten Bilder Das Logo des Ladens (`logo_url`) und die Fotos seiner Produkte (`paliers[].image_url`) haben Vorrang vor jeder Illustration. Ohne angegebene Farbe übernimmt die Karte die Farben des Logos. Die Fotos der Prämien werden freigestellt, grau bevor sie verdient sind, danach farbig. > **Achtung :** Die Bilder eines Ladeninhabers dienen SEINER Karte, die man ihm vorschlägt. Sie werden nirgendwo sonst veröffentlicht, und eine Illustration wird nie als Foto des Ladens ausgegeben. ## Icons und Lizenzen Wenn ein Foto nicht zu einer Prämie passt (unscharf, unpassend, verkleinert nicht lesbar), sucht der Skill ein Icon oder eine Illustration mit klarer Lizenz, die die Prämie auf den ersten Blick zeigt: - Icons von **Lucide**, **Phosphor**, **Tabler** (MIT oder ISC), in den Farben des Ladens eingefärbt; - Fotos und Illustrationen von **Unsplash** oder **Pexels**; - oder eines der rund sechzig eingebauten Icons (`paliers[].icone`). ## Jede Karte prüfen Bevor etwas gezeigt wird, öffnet sich jede Karte in groß: Name vollständig, Prämien lesbar und nicht abgeschnitten, Text mit genug Kontrast, Logo scharf, Fotos erkennbar, auch in Grau. Eine Karte, die durchfällt, wird neu gemacht. ## Vorlegen, dann live schalten Eine nummerierte Übersicht pro Typ, eine Zeile pro Version, und immer derselbe Satz: Jedes Bild und jedes Icon lässt sich ändern. Der Ladeninhaber wählt eine Nummer; erst dann schaltet [`creer_commerce`](https://stampywallet.com/de/docs/mcp/werkzeuge/creer_commerce/) die Karte live (Vorschau, dann Zustimmung). ![Beispiel einer Kartenübersicht](https://placehold.co/600x400 "Eine nummerierte Übersicht: eine Karte pro Form, nach Typ geordnet.") *Eine nummerierte Übersicht: eine Karte pro Form, nach Typ geordnet.* Source : https://stampywallet.com/de/docs/skill/methode/