API & Integrationen

Einstellungen → API & Integrationen hat drei Tabs: API-Schlüssel, Webhooks und Integrationen.
Die API und API-Schlüssel sind in jedem Tarif kostenlos, auch in Free Forever; es gibt kein API-Add-on. Über die API vergebene Stempel sind Card Operations wie alle anderen und stoppen daher, wenn die Card Operations des Tarifs aufgebraucht sind. Webhooks sind der kostenpflichtige Teil, siehe unten.
Kostet die API extra?
Nein. Die API und API-Schlüssel sind in jedem Tarif kostenlos, auch in Free Forever. Darüber vergebene Stempel sind Card Operations wie alle anderen.
Kann ich die API mit Free Forever nutzen?
Ja. Wenn die Card Operations des Tarifs aufgebraucht sind, stoppen Stempel über die API wie alle anderen.
Wo sind die API-Einstellungen?
In Einstellungen → API & Integrationen, mit drei Tabs — API-Schlüssel, Webhooks und Integrationen.
API-Schlüssel

Ein API-Schlüssel wird unter API-Schlüssel → API-Schlüssel hinzufügen für ein Personal-Login erstellt. Ein Personal-Login hat höchstens einen API-Schlüssel, und ein ausgeschaltetes Personal-Login kann nicht gewählt werden. Gibt es kein Personal-Login zur Auswahl, bietet das Fenster „API-Schlüssel generieren“ an, direkt dort eines zu erstellen; ein neues Personal-Login braucht einen freien Staff Seat, und bei einem vollen Tarif bietet das Fenster stattdessen an, einen Platz hinzuzufügen oder einen Tarif zu wählen.
Jeder mit einem API-Schlüssel gemachte Aufruf handelt als dessen Personal-Login: Er erreicht nur das Unternehmen dieses Personal-Logins, stempelt die dafür unter „Automatisches Stempeln“ gewählte Stempelkarte, und seine Stempel zählen als Card Operations dieses Personal-Logins.
Der Schlüssel kann jederzeit erneut in der Liste der API-Schlüssel angezeigt und kopiert werden. Er kann auch als QR-Code angezeigt werden, um ihn in ein Terminal zu scannen, und mit dem Namen des Personal-Logins gedruckt werden.
Wie erstelle ich einen API-Schlüssel?
Wählen Sie in Einstellungen → API & Integrationen → API-Schlüssel „API-Schlüssel hinzufügen“ und wählen Sie ein Personal-Login. Jedes Personal-Login hat höchstens einen API-Schlüssel.
Ich habe meinen API-Schlüssel verloren. Brauche ich einen neuen?
Nein. Der Schlüssel kann jederzeit erneut in der Liste der API-Schlüssel angezeigt und kopiert oder als QR-Code angezeigt werden.
Welche Stempelkarte stempeln API-Aufrufe?
Die für das Personal-Login des Schlüssels unter „Automatisches Stempeln“ gewählte. Ihre Stempel zählen als Card Operations dieses Personal-Logins.
Warum kann ich für einen neuen Schlüssel kein Personal-Login wählen?
Ein ausgeschaltetes Personal-Login kann nicht gewählt werden, und ein Personal-Login, das bereits einen Schlüssel hat, kann keinen zweiten erhalten. Gibt es keines zur Auswahl, bietet das Fenster an, ein Personal-Login zu erstellen.
Wann ein API-Schlüssel nicht mehr funktioniert
Ein API-Schlüssel läuft nicht ab. Er funktioniert nur dann nicht mehr, wenn er neu generiert oder gelöscht wird oder wenn sein Personal-Login ausgeschaltet oder gelöscht wird. Ein neues Passwort oder ein neuer Login für das Personal-Login wirkt sich nicht auf ihn aus.
- Neu generieren gibt dem Personal-Login einen neuen API-Schlüssel; der alte funktioniert sofort nicht mehr.
- Löschen stoppt den Schlüssel sofort. Das Personal-Login selbst funktioniert in 7Stamp Scanner weiter und kann später einen neuen Schlüssel erhalten.
- Beim Ausschalten eines Personal-Logins bleibt sein Schlüssel erhalten: Wird das Personal-Login wieder eingeschaltet, funktioniert derselbe Schlüssel wieder.
Läuft ein API-Schlüssel ab?
Nein. Er funktioniert nur dann nicht mehr, wenn er neu generiert oder gelöscht wird oder wenn sein Personal-Login ausgeschaltet oder gelöscht wird.
Ich habe das Passwort des Personal-Logins geändert. Brauche ich einen neuen API-Schlüssel?
Nein. Ein neues Passwort oder ein neuer Login wirkt sich nicht auf den API-Schlüssel aus.
Ich habe ein Personal-Login wieder eingeschaltet. Funktioniert sein alter API-Schlüssel?
Ja. Beim Ausschalten eines Personal-Logins bleibt sein Schlüssel erhalten, und derselbe Schlüssel funktioniert wieder, sobald es wieder eingeschaltet ist.
Was die API tut
Über die API kann ein System:
- eine Stempelkarte als Link oder QR ausgeben;
- Stempel hinzufügen;
- eine Karte mit ihren Stempeln, Zielen und Gutscheinen lesen;
- einen Gutschein direkt auf eine Karte ausgeben;
- einen Gutschein über seinen Gutscheincode einlösen;
- einem Käufer eine Nachricht senden.
Die API findet die Karte eines Käufers über die eigene Kennung des Unternehmens, etwa eine CRM-ID, Telefonnummer oder E-Mail, gesendet als external_id. Die Kennung wird auf der Karte gespeichert und kommt in jedem Webhook zu dieser Karte zurück. Die API hat keinen Aufruf, der die Käufer eines Unternehmens auflistet: Die gesamte Käuferbasis wird nur über den Export im Admin-Panel entnommen.
Statt mit einem API-Schlüssel kann sich eine App mit Login und Passwort eines Personal-Logins anmelden — für ein Gerät, an dem sich ein Kassierer anmeldet. Ein API-Schlüssel eignet sich für ein Gerät, das unbeaufsichtigt läuft. Webhooks werden nur im Admin-Panel hinzugefügt; die API hat keinen Aufruf, um Ereignisse zu abonnieren oder aufzulisten.
Die API setzt kein Limit für die Anfragerate: Aufrufe werden weder nach Anzahl noch nach Häufigkeit gedrosselt, und dieselbe Karte kann sofort erneut gescannt werden. Was das Stempeln darüber begrenzt, sind die Card Operations des Tarifs.
Können wir Stempel aus unserem eigenen CRM oder POS hinzufügen?
Ja, über die API. Sie gibt Stempelkarten aus, fügt Stempel hinzu, liest Karten und löst Gutscheine ein. Damit Ihr System über Ereignisse informiert wird, fügen Sie einen Webhook hinzu — dafür ist das Add-on Webhooks & Events nötig.
Können wir Daten exportieren?
Über die API lesen Sie Karten anhand Ihrer eigenen Kennung, und Webhooks senden Ereignisse, sobald sie eintreten. Die API hat keine Liste aller Käufer — die gesamte Käuferbasis wird über den Export im Admin-Panel entnommen.
Wie findet die API die Karte eines Käufers?
Über Ihre eigene Kennung — eine CRM-ID, Telefonnummer oder E-Mail —, gesendet als external_id. Sie wird auf der Karte gespeichert und kommt in jedem Webhook zu dieser Karte zurück.
Kann ich Webhooks über die API abonnieren?
Nein. Webhooks werden nur im Admin-Panel hinzugefügt.
Hat die API ein Rate Limit?
Nein. Aufrufe werden weder nach Anzahl noch nach Häufigkeit gedrosselt, und dieselbe Karte kann sofort erneut gescannt werden. Das Stempeln wird nur durch die Card Operations des Tarifs begrenzt.
API-Referenz
Die API-Referenz ist öffentlich und braucht keine Anmeldung: Swagger unter https://api.7loc.com/cards-api/docs, mit der OpenAPI-Datei unter https://api.7loc.com/cards-api/openapi.json. Aufrufe gehen an https://api.7loc.com/cards-api und brauchen einen API-Schlüssel oder ein Personal-Login.
Ein White Label-Unternehmen sieht im Admin-Panel keinen Link zur API-Referenz. Seine API-Schlüssel und Webhooks funktionieren genauso.
Wo ist die API-Dokumentation?
Swagger unter https://api.7loc.com/cards-api/docs, öffentlich und ohne Anmeldung. Die OpenAPI-Datei liegt unter https://api.7loc.com/cards-api/openapi.json.
Wie lautet die Basisadresse für API-Aufrufe?
https://api.7loc.com/cards-api. Aufrufe brauchen einen API-Schlüssel oder ein Personal-Login.
Unser White Label-Admin-Panel hat keinen Link zur API-Dokumentation. Funktioniert die API für uns?
Ja. Ein White Label-Unternehmen sieht keinen Link zur Referenz, aber seine API-Schlüssel und Webhooks funktionieren genauso.
Webhooks

Ein Webhook wird unter API & Integrationen → Webhooks → Webhook hinzufügen angelegt, mit der URL, die die Ereignisse empfängt. In 7Stamp wird ein Webhook für Stempelkarten-Ereignisse erstellt. Ein Unternehmen kann mehrere Webhooks hinzufügen, jeden mit eigener URL.
Webhooks brauchen das Add-on Webhooks & Events, €19 pro Monat, das nur bei kostenpflichtigen Tarifen angeboten wird. Beim Hinzufügen des ersten Webhooks wird angeboten, es zu kaufen; ohne das Add-on kann ein Webhook weder erstellt noch wieder eingeschaltet werden. Ein Add-on hält einen Webhook eingeschaltet: Weitere können hinzugefügt werden, aber jede Abrechnungsaktualisierung des Abonnements schaltet alle außer dem ältesten aus.
Webhooks senden Ereignisse, sobald sie eintreten, ab dem Moment, in dem der Webhook hinzugefügt wird. Frühere Ereignisse werden nicht gesendet.
Sind Webhooks kostenlos?
Nein. Sie brauchen das Add-on Webhooks & Events, €19 pro Monat, das nur bei kostenpflichtigen Tarifen angeboten wird. Die API selbst ist kostenlos.
Ich habe einen zweiten Webhook hinzugefügt, und er wurde ausgeschaltet. Warum?
Ein Add-on Webhooks & Events hält einen Webhook eingeschaltet. Jede Abrechnungsaktualisierung des Abonnements schaltet alle außer dem ältesten aus.
Sendet ein neuer Webhook vergangene Ereignisse?
Nein. Ereignisse werden ab dem Moment gesendet, in dem der Webhook hinzugefügt wird.
Webhook-Ereignisse
Ein Webhook erhält fünfzehn Stempelkarten-Ereignisse, benannt in event_type: SCAN, DELIVERY_INSERT, RECEIPT_SCAN, CARD_JOINED, REWARD_EARNED, VOUCHER_ISSUED, VOUCHER_PACK, ADMIN_VOUCHER_ISSUE, VOUCHER_REDEEMED, LOTTERY_WIN, CARD_CAMPAIGN, BIRTHDAY_GREETING, AUTO_MESSAGE_VOUCHER, CARD_ADDED_TO_WALLET und CARD_REMOVED_FROM_WALLET. Die letzten beiden kommen, wenn der Pass zu einer Wallet hinzugefügt oder aus einer entfernt wird, mit der Wallet, Apple oder Google.
Ein Scan, der keinen Stempel hinzufügt, etwa ein Kauf unter dem Stempelpreis, sendet trotzdem SCAN mit null hinzugefügten Stempeln. Ein an einem Rad gewonnener Preis wird durch ein einziges LOTTERY_WIN beim Drehen des Rads gemeldet, nicht durch REWARD_EARNED oder VOUCHER_ISSUED; ein Rad, das auf seine Drehung wartet, sendet noch nichts.
Käuferbewertungen sind keine Stempelkarten-Ereignisse. Jede neue Bewertung sendet ein Ereignis mit Entität review und Aktion created an die Webhooks, bei denen auf der Seite des Webhooks „Bewertungen“ unter den Objekten angehakt ist. Ein hier hinzugefügter Webhook ist nur für Stempelkarten-Ereignisse eingerichtet und erhält Bewertungen daher erst, wenn „Bewertungen“ angehakt ist.
Wird ein Webhook gesendet, wenn ein Scan keinen Stempel hinzufügt?
Ja. Ein Scan, der keinen Stempel hinzufügt, etwa ein Kauf unter dem Stempelpreis, sendet trotzdem SCAN mit null hinzugefügten Stempeln.
Welches Ereignis meldet mir, dass ein Käufer am Rad gewonnen hat?
LOTTERY_WIN, einmal gesendet, wenn das Rad gedreht wird. Ein Rad, das auf seine Drehung wartet, sendet noch nichts.
Kann ich erkennen, wann ein Käufer die Karte aus seiner Wallet entfernt?
Ja. Das Hinzufügen des Passes zu einer Wallet und sein Entfernen senden CARD_ADDED_TO_WALLET und CARD_REMOVED_FROM_WALLET, mit der Wallet, Apple oder Google.
Wie erhalte ich neue Käuferbewertungen über einen Webhook?
Öffnen Sie die Seite des Webhooks und haken Sie „Bewertungen“ unter seinen Objekten an. Jede neue Bewertung kommt dann mit Entität review und Aktion created an; ein unter „API & Integrationen“ hinzugefügter Webhook erhält bis dahin nur Stempelkarten-Ereignisse.
Wann jedes Ereignis gesendet wird
| Ereignis | Gesendet, wenn |
|---|---|
SCAN | Ein Personal-Login scannt die Karte: in 7Stamp Scanner, über die API oder von einem POS wie Toast. In 7Stamp Scanner entfernte Stempel sind ein SCAN mit negativem stamps_added |
DELIVERY_INSERT | Ein Käufer öffnet einen Stempelcode, der Stempel gibt — einen QR, einen Link, den Code selbst oder eine über die API erstellte Einladung |
RECEIPT_SCAN | Ein Käufer scannt einen Fiskalbeleg im Chatbot des Unternehmens, und er wird gestempelt; amount ist die Belegsumme |
CARD_JOINED | Ein Käufer erhält eine neue Stempelkarte, auf welchem Weg auch immer, mit der von Ihnen übergebenen external_id |
REWARD_EARNED | Ein Scan erreicht ein Award-Ziel |
VOUCHER_ISSUED | Ein Scan erreicht ein Gutschein-Ziel |
LOTTERY_WIN | Ein Lottery-Rad wird gedreht und gibt einen Preis |
VOUCHER_PACK | Eine neue Karte erhält das Gutscheinpaket der Stempelkarte, alle Gutscheine in einem Ereignis |
ADMIN_VOUCHER_ISSUE | Ein Gutschein wird direkt auf eine Karte ausgegeben, im Admin-Panel oder über die API |
VOUCHER_REDEEMED | Ein Gutschein auf einer Karte wird eingelöst: in 7Stamp Scanner, über die API, an einem Toast-POS oder vom Käufer |
CARD_CAMPAIGN | Eine Kampagne erreicht die Karte, einmal pro Karte, mit dem Gutschein der Kampagne, falls sie einen hat |
BIRTHDAY_GREETING | Der Geburtstagsgruß geht für die Karte hinaus, mit dem Geburtstagsgutschein, falls einer ausgegeben wurde |
AUTO_MESSAGE_VOUCHER | Ein Auslöser einer Auto-Nachricht legt einen Gutschein auf die Karte, egal ob danach ein Kanal den Käufer erreicht |
CARD_ADDED_TO_WALLET | Der Pass wird zu Apple Wallet oder Google Wallet hinzugefügt |
CARD_REMOVED_FROM_WALLET | Der Pass wird aus einer Wallet entfernt |
Jedes Ziel, das ein Scan erreicht, sendet nach dem Ereignis des Scans ein eigenes Ereignis, und ein Ziel, das ein Scan über zwei Runden der Karte zweimal erreicht, sendet zwei. Eine volle Karte, die eine neue Runde beginnt, ist dieselbe Karte und sendet kein CARD_JOINED; eine Karte, die erneut ausgestellt wird, nachdem ein Admin die alte gelöscht hat, schon. Bringt ein Beitritt ein Gutscheinpaket und Stempel, kommt zuerst CARD_JOINED, dann VOUCHER_PACK, dann DELIVERY_INSERT.
Ein Stempelcode ohne Stempel sendet kein DELIVERY_INSERT, ein im Admin-Panel ohne Karte generierter Gutschein sendet kein ADMIN_VOUCHER_ISSUE, und ein wiederholter API-Aufruf für einen bereits eingelösten Gutschein sendet kein zweites VOUCHER_REDEEMED.
Welches Ereignis meldet mir, dass ein Käufer ein Ziel erreicht hat?
REWARD_EARNED für ein Award-Ziel, VOUCHER_ISSUED für ein Gutschein-Ziel und LOTTERY_WIN für eine Lottery, jeweils nach dem eigenen Ereignis des Scans gesendet.
Wird ein Webhook gesendet, wenn Stempel entfernt werden?
Ja. In 7Stamp Scanner entfernte Stempel kommen als SCAN mit negativem stamps_added an.
Was ist der Unterschied zwischen VOUCHER_ISSUED und ADMIN_VOUCHER_ISSUE?
VOUCHER_ISSUED kommt, wenn ein Scan ein Gutschein-Ziel erreicht. ADMIN_VOUCHER_ISSUE kommt, wenn ein Gutschein direkt auf eine Karte ausgegeben wird, von Hand im Admin-Panel oder über die API.
Sendet ein Käufer, der mit einem Stempelcode beitritt, ein Ereignis oder mehrere?
Mehrere. Zuerst kommt CARD_JOINED, dann VOUCHER_PACK, wenn die Stempelkarte ein Gutscheinpaket hat, dann DELIVERY_INSERT mit den Stempeln.
Erhalte ich für jede Kampagnennachricht ein Ereignis?
CARD_CAMPAIGN wird einmal für jede Karte gesendet, die die Kampagne erreicht, mit dem Gutschein der Kampagne, falls sie einen enthält.
Was ein Webhook erhält
Jedes Ereignis hat denselben JSON-Body: die Ereignis-ID, das Unternehmen und das Ereignis mit seinem Typ, der Stempelkarte, den Stempeln vorher und nachher, dem Kaufbetrag, der Bestell-ID und der external_id, die die Integration gesendet hat, dem Personal-Login, das bedient hat, den vergebenen Gutscheinen und Belohnungen sowie Name, E-Mail, Telegram, WhatsApp-Nummer und Geburtsdatum des Käufers.
amount ist der Kaufbetrag in der kleinsten Währungseinheit (Cent): Ein mit dem Scan gesendeter Betrag von 12.50 kommt als 1250 an. Er ist leer, wenn das Ereignis keinen Betrag hatte.
Die Ereignis-ID steht im Body und im Header X-Webhook-Event-Id. Eine Wiederholung desselben Ereignisses behält ihre ID, sodass ein Empfänger Duplikate verwerfen kann. Bei einer Make- oder Zapier-URL steht das Ereignis unter dem Schlüssel card_event statt data.
Welche Daten über den Käufer enthält ein Webhook?
Name, E-Mail, Telegram, WhatsApp-Nummer und Geburtsdatum, zusammen mit der Stempelkarte, den Stempeln vorher und nachher sowie den vergebenen Gutscheinen und Belohnungen.
In welcher Einheit ist amount angegeben?
In der kleinsten Währungseinheit (Cent). Ein mit dem Scan gesendeter Betrag von 12.50 kommt als 1250 an; er ist leer, wenn das Ereignis keinen Betrag hatte.
Wie vermeide ich, dasselbe Ereignis zweimal zu verarbeiten?
Verwenden Sie die Ereignis-ID, im Body und im Header X-Webhook-Event-Id. Eine Wiederholung behält dieselbe ID.
Warum steht das Ereignis in Make unter card_event?
Bei einer Make- oder Zapier-URL steht das Ereignis unter dem Schlüssel card_event statt data, damit ihre Apps es unterscheiden können.
Signatur
Jede Zustellung ist signiert. Der Header X-Webhook-Signature enthält einen Zeitstempel und einen HMAC-SHA256 aus diesem Zeitstempel und dem unveränderten Body, berechnet mit dem geheimen Schlüssel des Webhooks. Der geheime Schlüssel wird auf der Seite des Webhooks angezeigt und neu generiert. Login und Passwort für Basic Auth können ebenfalls hinzugefügt werden.
Wie prüfe ich, ob ein Webhook wirklich von 7Stamp kommt?
Berechnen Sie den HMAC-SHA256 aus dem Zeitstempel und dem unveränderten Body mit dem geheimen Schlüssel des Webhooks und vergleichen Sie ihn mit dem Header X-Webhook-Signature.
Wo finde ich den geheimen Schlüssel des Webhooks?
Auf der Seite des Webhooks, wo er auch neu generiert werden kann.
Kann ich meinen Endpunkt mit einem Passwort schützen?
Ja. Dem Webhook können zusätzlich zur Signatur ein Login und ein Passwort für Basic Auth hinzugefügt werden.
Fehlgeschlagene Zustellungen
Eine Zustellung, die innerhalb von dreißig Sekunden keine 2xx-Antwort erhält, wird bis zu zehnmal wiederholt, wobei jede Wartezeit vier Sekunden länger ist als die vorige, sodass die Wiederholungen innerhalb von etwa vier Minuten enden. Eine 429-Antwort mit Retry-After wird nach dieser Zeit wiederholt. Der erste Fehlschlag eines Ereignisses erzeugt eine Benachrichtigung im Admin-Panel.
Nach hundert fehlgeschlagenen Zustellungen in Folge wird der Webhook vom System gesperrt und erhält keine Ereignisse mehr. Seine Seite warnt vorher und hat eine Schaltfläche „Entsperren“; eine erfolgreiche Zustellung setzt den Zähler zurück.
Die Seite jedes Webhooks hat ein Protokoll seiner Zustellungen mit der gesendeten Anfrage und der erhaltenen Antwort. „Erneut senden“ sendet dasselbe Ereignis noch einmal, nur an diesen Webhook.
Mein Server war ausgefallen. Sind die Ereignisse verloren?
Jede Zustellung wird innerhalb von etwa vier Minuten bis zu zehnmal wiederholt. Danach öffnen Sie das Protokoll des Webhooks und verwenden „Erneut senden“ für die benötigten Ereignisse.
Warum empfängt mein Webhook keine Ereignisse mehr?
Nach hundert fehlgeschlagenen Zustellungen in Folge wird er vom System gesperrt. Beheben Sie das Problem am Endpunkt und drücken Sie „Entsperren“ auf der Seite des Webhooks.
Kann ich sehen, was an meinen Webhook gesendet wurde?
Ja. Die Seite jedes Webhooks hat ein Protokoll der Zustellungen mit der gesendeten Anfrage und der erhaltenen Antwort.
Tab „Integrationen“

Der Tab „Integrationen“ listet die fertigen Wege nach Gruppen auf:
- Stempel an Ihrer Kasse — Poster, Toast, „Ihr eigenes POS oder CRM“ und „Ihr POS ist nicht dabei?“;
- Fiskalbelege — SmartKasa;
- Automatisierung — Make, Zapier und Public Swagger.
Jede Karte gibt an, ob sie einen API-Schlüssel braucht. Der Tab bietet in jedem Land dieselben Karten; nur Fiskalbelege sind auf bestimmte Länder beschränkt.

Ein White Label-Unternehmen sieht keine Karte für Make, Zapier oder Public Swagger, und ihm werden weder Poster noch die Einrichtungsanleitungen auf 7stamp.com angeboten.
Welche POS-Systeme sind bereit zum Verbinden?
Poster, und Toast, sobald es für die Plattform eingeschaltet ist — bis dahin zeigt es „Demnächst“. Andere Systeme verbinden sich über die API, mit „Ihr eigenes POS oder CRM“.
Sind Integrationen auf bestimmte Länder beschränkt?
Nein. Der Tab bietet in jedem Land dieselben Karten. Nur Fiskalbelege sind auf bestimmte Länder beschränkt.
Warum sehe ich Make und Zapier nicht?
Sie werden einem White Label-Unternehmen nicht angezeigt. Seine API-Schlüssel und Webhooks funktionieren genauso.
Poster
Poster ist unsere App im Poster-Marketplace. „In Poster installieren“ öffnet ihren Eintrag, und die App wird mit dem API-Schlüssel eines Personal-Logins eingerichtet. Ihre Stempel zählen als Card Operations dieses Personal-Logins.
Wie verbinde ich Poster?
Öffnen Sie Integrationen → Poster und wählen Sie „In Poster installieren“. Die App wird mit dem API-Schlüssel eines Personal-Logins eingerichtet.
Wessen Card Operations verbrauchen Stempel aus Poster?
Die des Personal-Logins, dessen API-Schlüssel die App verwendet.
Brauche ich für Poster einen API-Schlüssel?
Ja, den API-Schlüssel eines Personal-Logins.
Toast
Toast zeigt für jedes Unternehmen „Demnächst“, bis der Toast-Zugang auf der Plattform eingerichtet ist. Er ist ein einziger Schalter für die ganze Plattform, keine Einstellung des Unternehmens; sobald er eingeschaltet ist, enthält die Toast-Karte die Einrichtung selbst.
Jeder Toast-Standort wird über seine GUID mit einem Personal-Login verbunden, ohne API-Schlüssel: Unternehmen, Stempelkarte und Tarif dieses Personal-Logins gelten für jede Toast-Anfrage von diesem Standort. Ein Standort kann nur mit einem Personal-Login verbunden sein, und ein Personal-Login hat einen Standort. Anfragen von einem Standort werden abgelehnt, sobald er getrennt ist oder solange sein Personal-Login ausgeschaltet oder gelöscht ist.
Jedem Gutschein kann ein Produkt aus dem Toast-Menü zugeordnet werden: Am Toast-POS wird er dann zu einem Rabatt auf dieses Produkt. Ein Gutschein ohne Produkt wird als Rabatt von null auf den Bon angewendet, und der Kassierer übergibt das Geschenk von Hand. Gutscheine werden am Toast-POS eingelöst, und ein Rad, das durch einen bezahlten Bon erreicht wird, wird sofort gedreht. Wenn Toast eine Transaktion rückgängig macht, werden ihre Stempel zurückgenommen oder ihre eingelösten Gutscheine wiederhergestellt.
Ein Gast kann an einem Toast-Kiosk oder einem gästeseitigen Bildschirm mit einer Telefonnummer oder E-Mail beitreten. Die Stempelkarte wird sofort ausgestellt; der Gast erhält nichts von 7Stamp, bis er sie mit derselben Telefonnummer oder E-Mail öffnet.
Warum zeigt Toast „Demnächst“?
Der Toast-Zugang ist ein einziger Schalter für die ganze Plattform, keine Einstellung Ihres Unternehmens. Solange er nicht eingeschaltet ist, gibt es nichts zu verbinden.
Wie wird ein Toast-Standort verbunden?
Über seine GUID mit einem Personal-Login, ohne API-Schlüssel. Stempelkarte und Tarif dieses Personal-Logins gelten für jede Anfrage von diesem Standort.
Was passiert mit Stempeln, wenn Toast einen Bon storniert?
Wenn Toast eine Transaktion rückgängig macht, werden ihre Stempel zurückgenommen oder ihre eingelösten Gutscheine wiederhergestellt.
SmartKasa

SmartKasa braucht keinen API-Schlüssel. Es ist eine Belegquelle in „Belegscan“, hinzugefügt über eine SmartKasa-Shop-ID oder über den Unternehmenscode, um jeden Shop abzudecken. Käufer scannen den SmartKasa-Beleg im Chatbot des Unternehmens, und die Stempel gehen an das Personal-Login dieser Belegquelle.
SmartKasa ist ukrainisch, und Fiskalbelege funktionieren nur in der Ukraine, der Slowakei, Kasachstan und Usbekistan.
Brauche ich für SmartKasa einen API-Schlüssel?
Nein. SmartKasa ist eine Belegquelle in „Belegscan“, hinzugefügt über eine Shop-ID oder über den Unternehmenscode.
Wo scannen Käufer einen SmartKasa-Beleg?
Im Chatbot Ihres Unternehmens. Die Stempel gehen an das Personal-Login dieser Belegquelle.
In welchen Ländern funktionieren Fiskalbelege?
In der Ukraine, der Slowakei, Kasachstan und Usbekistan.
Make und Zapier

Die 7Stamp-App für Make ist in der öffentlichen App-Bibliothek von Make: Suchen Sie in einem beliebigen Make-Szenario nach 7Stamp oder verwenden Sie „In Make öffnen“ im Tab „Integrationen“. Unsere App für Zapier ist nicht im öffentlichen Verzeichnis von Zapier: „In Zapier öffnen“ ist eine Einladung, die die App dem eigenen Zapier-Konto des Unternehmens hinzufügt. Beide Apps arbeiten mit dem API-Schlüssel eines Personal-Logins.
Make-Szenarien und Zaps werden von 7Stamp-Webhooks gestartet, daher brauchen Trigger das Add-on Webhooks & Events. Aktionen wie das Hinzufügen von Stempeln oder das Ausgeben eines Gutscheins brauchen nur einen API-Schlüssel. Make und Zapier werden einem White Label-Unternehmen nicht angeboten.
Wo finde ich die 7Stamp-App in Make und Zapier?
Suchen Sie in Make in einem beliebigen Szenario nach 7Stamp — die App ist in der öffentlichen App-Bibliothek von Make. In Zapier ist sie noch nicht öffentlich, verwenden Sie daher „In Zapier öffnen“ im Tab „Integrationen“ — die Einladung fügt die App Ihrem eigenen Konto hinzu.
Brauchen Make und Zapier das Add-on Webhooks & Events?
Trigger ja, denn Szenarien und Zaps werden von 7Stamp-Webhooks gestartet. Aktionen wie das Hinzufügen von Stempeln oder das Ausgeben eines Gutscheins brauchen nur einen API-Schlüssel.
Brauche ich für Make oder Zapier einen API-Schlüssel?
Ja. Die Apps arbeiten mit dem API-Schlüssel eines Personal-Logins.