Referencia Működés

API, webhookok és integrációk

API-kulcsok személyzeti bejelentkezésekhez, mit tud az API, a webhookok és eseményeik, a tartalom, az aláírás és az újrapróbálkozások, valamint a kész integrációk: Poster, Toast, SmartKasa, Make és Zapier.

Gyors olvasás

Frissítve: 2026. november 19.

API és integrációk

API-kulcsok az API és integrációk alatt

A Beállítások → API és integrációk alatt három lap van: API-kulcsok, Webhookok és Integrációk.

Az API és az API-kulcsok minden csomagon ingyenesek, a Free Forever csomagon is; nincs API-kiegészítő. Az API-n keresztül adott pecsétek ugyanúgy Card Operations, mint bármely más, ezért leállnak, amikor a csomag Card Operations kerete elfogy. A webhookok a fizetős rész, lásd alább.

Kerül az API külön pénzbe?

Nem. Az API és az API-kulcsok minden csomagon ingyenesek, a Free Forever csomagon is. A rajta keresztül adott pecsétek ugyanúgy Card Operations, mint bármely más.

Használhatom az API-t Free Forever csomagon?

Igen. Ha a csomag Card Operations kerete elfogy, az API-n keresztüli pecsételés is leáll, mint bármely más.

Hol vannak az API-beállítások?

A Beállítások → API és integrációk alatt, három lappal – API-kulcsok, Webhookok és Integrációk.

API-kulcsok

API-kulcs generálása egy személyzeti bejelentkezéshez

Az API-kulcs az API-kulcsok → API-kulcs hozzáadása alatt jön létre, egy személyzeti bejelentkezéshez. Egy személyzeti bejelentkezésnek legfeljebb egy API-kulcsa van, és kikapcsolt személyzeti bejelentkezés nem választható. Ha nincs választható személyzeti bejelentkezés, az API-kulcs generálása ablak felkínálja, hogy ott helyben hozz létre egyet; egy új személyzeti bejelentkezéshez szabad Staff Seat kell, és betelt csomag esetén az ablak helyette Staff Seat hozzáadását vagy csomagválasztást kínál.

Minden API-kulccsal indított hívás a kulcs személyzeti bejelentkezéseként jár el: csak annak a személyzeti bejelentkezésnek a vállalkozását éri el, arra a pecsétkártyára ad pecsétet, amelyet hozzá az Automatikus pecsételés alatt kiválasztottak, és a pecsétjei ennek a személyzeti bejelentkezésnek a Card Operations keretébe számítanak.

A kulcs bármikor újra megtekinthető és kimásolható az API-kulcsok listájából. QR-kódként is megjeleníthető, hogy egy terminálba beolvassák, és kinyomtatható a személyzeti bejelentkezés nevével.

Hogyan hozhatok létre API-kulcsot?

A Beállítások → API és integrációk → API-kulcsok alatt válaszd az API-kulcs hozzáadása lehetőséget, és válassz egy személyzeti bejelentkezést. Minden személyzeti bejelentkezésnek legfeljebb egy API-kulcsa van.

Elvesztettem az API-kulcsomat. Újra van szükségem?

Nem. A kulcs bármikor újra megtekinthető és kimásolható az API-kulcsok listájából, vagy QR-kódként megjeleníthető.

Melyik pecsétkártyára adnak pecsétet az API-hívások?

Arra, amelyiket a kulcs személyzeti bejelentkezéséhez az Automatikus pecsételés alatt kiválasztottak. A pecsétjei ennek a személyzeti bejelentkezésnek a Card Operations keretébe számítanak.

Miért nem tudok személyzeti bejelentkezést választani egy új kulcshoz?

Kikapcsolt személyzeti bejelentkezés nem választható, és az a személyzeti bejelentkezés, amelynek már van kulcsa, nem kaphat másodikat. Ha nincs választható, az ablak felkínálja egy személyzeti bejelentkezés létrehozását.

Mikor áll le egy API-kulcs

Az API-kulcs nem jár le. Csak akkor áll le, ha újragenerálják vagy törlik, illetve ha a személyzeti bejelentkezését kikapcsolják vagy törlik. A személyzeti bejelentkezés új jelszava vagy felhasználóneve nem érinti.

  • Az Újragenerálás új API-kulcsot ad a személyzeti bejelentkezésnek; a régi azonnal leáll.
  • A Törlés azonnal leállítja a kulcsot. Maga a személyzeti bejelentkezés tovább működik a 7Stamp Scanner alkalmazásban, és később új kulcsot kaphat.
  • A személyzeti bejelentkezés kikapcsolása megtartja a kulcsát: amikor visszakapcsolják, ugyanaz a kulcs újra működik.

Lejár az API-kulcs?

Nem. Csak akkor áll le, ha újragenerálják vagy törlik, illetve ha a személyzeti bejelentkezését kikapcsolják vagy törlik.

Megváltoztattam a személyzeti bejelentkezés jelszavát. Új API-kulcs kell?

Nem. Az új jelszó vagy felhasználónév nem érinti az API-kulcsot.

Visszakapcsoltam egy személyzeti bejelentkezést. Működik a régi API-kulcsa?

Igen. A személyzeti bejelentkezés kikapcsolása megtartja a kulcsát, és ugyanaz a kulcs újra működik, amint visszakapcsolják.

Mit tud az API

Az API-n keresztül egy rendszer képes:

  • pecsétkártyát kiadni linkként vagy QR-kódként;
  • pecséteket hozzáadni;
  • beolvasni egy kártyát a pecsétjeivel, céljaival és utalványaival;
  • utalványt kiadni közvetlenül egy kártyára;
  • utalványt beváltani az utalványkódja alapján;
  • üzenetet küldeni egy vásárlónak.

Az API a vállalkozás saját azonosítója alapján találja meg a vásárló kártyáját, például CRM-ID, telefonszám vagy e-mail alapján, external_id néven elküldve. Az azonosító a kártyán tárolódik, és minden róla szóló webhookban visszajön. Az API-ban nincs olyan hívás, amely kilistázná a vállalkozás vásárlóit: a teljes vásárlói kör csak az admin exportján keresztül vihető ki.

API-kulcs helyett egy alkalmazás egy személyzeti bejelentkezés felhasználónevével és jelszavával is bejelentkezhet – olyan eszközön, amelyre egy pénztáros jelentkezik be. Az API-kulcs felügyelet nélkül futó eszközhöz való. Webhookokat csak az adminban lehet hozzáadni; az API-ban nincs hívás az eseményekre való feliratkozáshoz vagy azok listázásához.

Az API nem szab sebességkorlátot a kérésekre: a hívásokat sem darabszám, sem gyakoriság alapján nem korlátozzuk, és ugyanaz a kártya azonnal újra beolvasható. A rajta keresztüli pecsételést a csomag Card Operations kerete korlátozza.

Adhatunk pecséteket a saját CRM-ünkből vagy POS-unkból?

Igen, az API-n keresztül. Pecsétkártyákat ad ki, pecséteket ad hozzá, kártyákat olvas be és utalványokat vált be. Ha azt szeretnéd, hogy a rendszered értesüljön az eseményekről, adj hozzá egy webhookot – ehhez a Webhooks & Events kiegészítő kell.

Exportálhatunk adatokat?

Az API-n keresztül a saját azonosítód alapján olvasod be a kártyákat, a webhookok pedig valós időben küldik az eseményeket. Az API-ban nincs az összes vásárlót tartalmazó lista – a teljes vásárlói kör az admin exportján keresztül vihető ki.

Hogyan találja meg az API egy vásárló kártyáját?

A saját azonosítód alapján – CRM-ID, telefonszám vagy e-mail –, external_id néven elküldve. A kártyán tárolódik, és minden róla szóló webhookban visszajön.

Feliratkozhatok webhookokra az API-n keresztül?

Nem. Webhookokat csak az adminban lehet hozzáadni.

Van az API-nak sebességkorlátja?

Nincs. A hívásokat sem darabszám, sem gyakoriság alapján nem korlátozzuk, és ugyanaz a kártya azonnal újra beolvasható. A pecsételést csak a csomag Card Operations kerete korlátozza.

API-referencia

Az API-referencia nyilvános, és nem kell hozzá bejelentkezés: Swagger – https://api.7loc.com/cards-api/docs, az OpenAPI-fájl helye pedig https://api.7loc.com/cards-api/openapi.json. A hívások a https://api.7loc.com/cards-api címre mennek, és API-kulcs vagy személyzeti bejelentkezés kell hozzájuk.

A White Label vállalkozás nem lát linket az API-referenciára az adminban. Az API-kulcsai és a webhookjai ugyanúgy működnek.

Hol található az API-dokumentáció?

Swagger: https://api.7loc.com/cards-api/docs, nyilvános, bejelentkezés nélkül. Az OpenAPI-fájl helye: https://api.7loc.com/cards-api/openapi.json.

Mi az API-hívások alapcíme?

https://api.7loc.com/cards-api. A hívásokhoz API-kulcs vagy személyzeti bejelentkezés kell.

A White Label adminunkban nincs API-dokumentáció link. Működik nálunk az API?

Igen. A White Label vállalkozás nem lát linket a referenciára, de az API-kulcsai és a webhookjai ugyanúgy működnek.

Webhookok

Webhookok az API és integrációk alatt

Webhookot az API és integrációk → Webhookok → Webhook hozzáadása alatt lehet hozzáadni, az eseményeket fogadó URL megadásával. A 7Stampben a webhook pecsétkártya-eseményekhez jön létre. Egy vállalkozás több webhookot is hozzáadhat, mindegyiket saját URL-lel.

A webhookokhoz a Webhooks & Events kiegészítő kell, havi €19, csak fizetős csomagokon. Az első webhook hozzáadásakor az admin felkínálja a megvásárlását; nélküle webhook nem hozható létre és nem kapcsolható vissza. Egy kiegészítő egy webhookot tart bekapcsolva: többet is hozzá lehet adni, de az előfizetés minden számlázási frissítése a legrégebbi kivételével mindet kikapcsolja.

A webhookok a hozzáadásuk pillanatától valós időben küldik az eseményeket. A korábbi eseményeket nem küldik el.

Ingyenesek a webhookok?

Nem. Ezekhez a Webhooks & Events kiegészítő kell, havi €19, csak fizetős csomagokon. Maga az API ingyenes.

Hozzáadtam egy második webhookot, és kikapcsolódott. Miért?

Egy Webhooks & Events kiegészítő egy webhookot tart bekapcsolva. Az előfizetés minden számlázási frissítése a legrégebbi kivételével mindet kikapcsolja.

Küld egy új webhook korábbi eseményeket?

Nem. Az eseményeket a webhook hozzáadásának pillanatától küldjük.

Webhook-események

Egy webhook tizenöt pecsétkártya-eseményt kap, az event_type mezőben megnevezve: 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 és CARD_REMOVED_FROM_WALLET. Az utolsó kettő akkor érkezik, amikor a kártyát hozzáadják egy pénztárcához vagy eltávolítják belőle, a pénztárcával (Apple vagy Google).

A pecsétet nem adó szkennelés, például a pecsétár alatti vásárlás, is küld SCAN eseményt nulla hozzáadott pecséttel. A szerencsekeréken nyert nyereményt egyetlen LOTTERY_WIN jelzi, amikor a kereket megpörgetik, nem a REWARD_EARNED vagy a VOUCHER_ISSUED; a megpörgetésre váró kerék még semmit sem küld.

A vásárlói vélemények nem pecsétkártya-események. Minden új vélemény review entitással és created művelettel küld eseményt azoknak a webhookoknak, amelyeknek az oldalán az objektumok között be van jelölve a Vélemények. Az itt hozzáadott webhook csak pecsétkártya-eseményekre van beállítva, így csak a Vélemények bejelölése után kap véleményeket.

Küldünk webhookot, ha egy szkennelés nem ad pecsétet?

Igen. A pecsétet nem adó szkennelés, például a pecsétár alatti vásárlás, is küld SCAN eseményt nulla hozzáadott pecséttel.

Melyik esemény jelzi, hogy egy vásárló nyert a szerencsekeréken?

A LOTTERY_WIN, amelyet egyszer küldünk, amikor a kereket megpörgetik. A megpörgetésre váró kerék még semmit sem küld.

Megtudhatom, ha egy vásárló eltávolítja a kártyát a pénztárcájából?

Igen. A kártya pénztárcához adása és eltávolítása CARD_ADDED_TO_WALLET és CARD_REMOVED_FROM_WALLET eseményt küld, a pénztárcával (Apple vagy Google).

Hogyan kaphatom meg az új vásárlói véleményeket webhookon keresztül?

Nyisd meg a webhook oldalát, és jelöld be a Véleményeket az objektumai között. Ezután minden új vélemény review entitással és created művelettel érkezik; az API és integrációk alatt hozzáadott webhook addig csak pecsétkártya-eseményeket kap.

Mikor küldjük az egyes eseményeket

EseményMikor küldjük
SCANEgy személyzeti bejelentkezés beolvassa a kártyát: a 7Stamp Scanner alkalmazásban, az API-n keresztül vagy egy POS-ról, például a Toastról. A 7Stamp Scanner alkalmazásban levont pecsétek negatív stamps_added értékű SCAN eseményt adnak
DELIVERY_INSERTEgy vásárló megnyit egy pecsétet adó pecsétkódot – QR-kódot, linket, magát a kódot vagy az API-n keresztül készült meghívót
RECEIPT_SCANEgy vásárló beszkennel egy adóügyi nyugtát a vállalkozás csevegőrobotjában, és az pecsétet ad; az amount a nyugta végösszege
CARD_JOINEDEgy vásárló új pecsétkártyát kap, bármilyen módon, az általad átadott external_id értékkel
REWARD_EARNEDEgy szkennelés elér egy Award-célt
VOUCHER_ISSUEDEgy szkennelés elér egy utalványcélt
LOTTERY_WINEgy Lottery-kereket megpörgetnek, és az nyereményt ad
VOUCHER_PACKEgy új kártya megkapja a pecsétkártya utalványcsomagját, az összes utalványát egy eseményben
ADMIN_VOUCHER_ISSUEEgy utalványt közvetlenül egy kártyára adnak ki, az adminban vagy az API-n keresztül
VOUCHER_REDEEMEDEgy kártyán lévő utalványt beváltanak: a 7Stamp Scanner alkalmazásban, az API-n keresztül, egy Toast POS-nál vagy a vásárló maga
CARD_CAMPAIGNEgy kampány eléri a kártyát, kártyánként egyszer, a kampány utalványával, ha van
BIRTHDAY_GREETINGKimegy a születésnapi köszöntő a kártyára, a születésnapi utalvánnyal, ha kiadtak ilyet
AUTO_MESSAGE_VOUCHEREgy automatikus üzenet triggere utalványt tesz a kártyára, akár eléri utána a vásárlót egy csatorna, akár nem
CARD_ADDED_TO_WALLETA kártyát hozzáadják az Apple Wallet-hez vagy a Google Wallet-hez
CARD_REMOVED_FROM_WALLETA kártyát eltávolítják egy pénztárcából

Minden cél, amelyet egy szkennelés elér, saját eseményt küld a szkennelés eseménye után, és az a cél, amelyet egy szkennelés a kártya két körén át kétszer ér el, kettőt küld. Az új kört kezdő teli kártya ugyanaz a kártya, és nem küld CARD_JOINED eseményt; az a kártya viszont, amelyet azután adnak ki újra, hogy egy admin törölte a régit, küld. Ha egy csatlakozás utalványcsomagot és pecséteket is hoz, először a CARD_JOINED érkezik, majd a VOUCHER_PACK, utána a DELIVERY_INSERT.

A pecsét nélküli pecsétkód nem küld DELIVERY_INSERT eseményt, az adminban kártya nélkül generált utalvány nem küld ADMIN_VOUCHER_ISSUE eseményt, és egy már beváltott utalványra ismételt API-hívás nem küld második VOUCHER_REDEEMED eseményt.

Melyik esemény jelzi, hogy egy vásárló elért egy célt?

A REWARD_EARNED egy Award-célnál, a VOUCHER_ISSUED egy utalványcélnál és a LOTTERY_WIN egy Lottery esetén, mindegyiket a szkennelés saját eseménye után küldjük.

Küldünk webhookot, ha pecséteket vonnak le?

Igen. A 7Stamp Scanner alkalmazásban levont pecsétek SCAN eseményként érkeznek, negatív stamps_added értékkel.

Mi a különbség a VOUCHER_ISSUED és az ADMIN_VOUCHER_ISSUE között?

A VOUCHER_ISSUED akkor érkezik, amikor egy szkennelés elér egy utalványcélt. Az ADMIN_VOUCHER_ISSUE akkor, amikor egy utalványt közvetlenül egy kártyára adnak ki, kézzel az adminban vagy az API-n keresztül.

Egy pecsétkóddal csatlakozó vásárló egy eseményt küld vagy többet?

Többet. Először a CARD_JOINED érkezik, majd a VOUCHER_PACK, ha a pecsétkártyának van utalványcsomagja, utána a DELIVERY_INSERT a pecsétekkel.

Kapok eseményt minden kampányüzenetről?

A CARD_CAMPAIGN eseményt egyszer küldjük minden kártyára, amelyet a kampány elér, a kampány utalványával, ha tartozik hozzá.

Mit kap egy webhook

Minden esemény törzse ugyanolyan JSON: az esemény azonosítója, a vállalkozás, valamint maga az esemény a típusával, a pecsétkártyával, az előtte és utána lévő pecsétekkel, a vásárlás összegével, az integráció által küldött rendelésazonosítóval és external_id értékkel, az azt kiszolgáló személyzeti bejelentkezéssel, az általa adott utalványokkal és jutalmakkal, valamint a vásárló nevével, e-mail-címével, Telegramjával, WhatsApp-telefonszámával és születési dátumával.

Az amount a vásárlás összege váltópénzegységben (centben): a szkenneléssel küldött 12.50 összeg 1250-ként érkezik. Üres, ha az eseményhez nem tartozott összeg.

Az esemény azonosítója a törzsben és az X-Webhook-Event-Id fejlécben található. Ugyanannak az eseménynek az újrapróbálkozása megtartja az azonosítóját, így a fogadó kiszűrheti az ismétléseket. Make- vagy Zapier-URL esetén az esemény a data helyett a card_event kulcs alatt van.

Milyen adatokat tartalmaz egy webhook a vásárlóról?

Nevet, e-mail-címet, Telegramot, WhatsApp-telefonszámot és születési dátumot, a pecsétkártyával, az előtte és utána lévő pecsétekkel, valamint a kiadott utalványokkal és jutalmakkal együtt.

Milyen egységben van az amount?

Váltópénzegységben (centben). A szkenneléssel küldött 12.50 összeg 1250-ként érkezik; üres, ha az eseményhez nem tartozott összeg.

Hogyan kerülhetem el, hogy ugyanazt az eseményt kétszer dolgozzam fel?

Használd az esemény azonosítóját (ID), amely a törzsben és az X-Webhook-Event-Id fejlécben található. Az újrapróbálkozás ugyanazt az azonosítót tartja meg.

Miért van az esemény a card_event alatt a Make-ben?

Make- vagy Zapier-URL esetén az esemény a data helyett a card_event kulcs alatt van, hogy az alkalmazásaik meg tudják különböztetni.

Aláírás

Minden kézbesítés alá van írva. Az X-Webhook-Signature fejléc egy időbélyeget és az időbélyeg és a nyers törzs HMAC-SHA256 értékét tartalmazza, a webhook titkos kulcsával. A titkos kulcs a webhook oldalán jelenik meg, és ott generálható újra. Basic auth felhasználónév és jelszó is hozzáadható.

Hogyan ellenőrizhetem, hogy egy webhook valóban a 7Stamptől jön?

Számítsd ki az időbélyeg és a nyers törzs HMAC-SHA256 értékét a webhook titkos kulcsával, és hasonlítsd össze az X-Webhook-Signature fejléccel.

Hol találom a webhook titkos kulcsát?

A webhook oldalán, ahol újra is generálható.

Védhetem a végpontomat jelszóval?

Igen. Az aláíráson felül egy Basic auth felhasználónév és jelszó is hozzáadható a webhookhoz.

Sikertelen kézbesítések

Azt a kézbesítést, amely harminc másodpercen belül nem kap 2xx választ, legfeljebb tízszer próbáljuk újra, minden várakozás négy másodperccel hosszabb az előzőnél, így az újrapróbálkozások körülbelül négy percen belül véget érnek. A Retry-After fejléces 429-es választ ennyi idő után próbáljuk újra. Egy esemény első sikertelensége értesítést helyez el az adminban.

Száz egymást követő sikertelen kézbesítés után a rendszer letiltja a webhookot, és az nem kap több eseményt. Az oldala előtte figyelmeztet, és van rajta Blokkolás feloldása gomb; egy sikeres kézbesítés nullázza a számlálót.

Minden webhook oldalán van egy kézbesítési napló, az elküldött kéréssel és a kapott válasszal. Az Újraküldés ugyanazt az eseményt küldi el újra, csak ennek a webhooknak.

Leállt a szerverem. Elvesztek az események?

Minden kézbesítést legfeljebb tízszer próbálunk újra, körülbelül négy percen belül. Utána nyisd meg a webhook naplóját, és a szükséges eseményeknél használd az Újraküldés gombot.

Miért nem kap többé eseményeket a webhookom?

Száz egymást követő sikertelen kézbesítés után a rendszer letiltja. Javítsd ki a végpontot, és nyomd meg a Blokkolás feloldása gombot a webhook oldalán.

Láthatom, mit küldtek a webhookomnak?

Igen. Minden webhook oldalán van egy kézbesítési napló az elküldött kéréssel és a kapott válasszal.

Integrációk lap

Az Integrációk lap

Az Integrációk lap csoportonként sorolja fel a kész megoldásokat:

  • Pecsételés a pénztárnál – Poster, Toast, Saját POS vagy CRM rendszer és Nem látod a POS-odat?;
  • Adóügyi nyugták – SmartKasa;
  • Automatizálás – Make, Zapier és Public Swagger.

Minden kártyán látszik, hogy kell-e hozzá API-kulcs. A lap minden országban ugyanazokat a kártyákat kínálja; csak az adóügyi nyugták országhoz kötöttek.

Saját POS vagy CRM rendszer

A White Label vállalkozás nem lát Make, Zapier vagy Public Swagger kártyát, és nem kínáljuk neki a Postert, sem a 7stamp.com beállítási útmutatóit.

Mely POS-rendszerek csatlakoztathatók azonnal?

A Poster, valamint a Toast, amint a platformon bekapcsolják – addig Hamarosan érkezik feliratot mutat. Más rendszerek az API-n keresztül csatlakoznak, a Saját POS vagy CRM rendszer kártyával.

Országhoz kötöttek az integrációk?

Nem. A lap minden országban ugyanazokat a kártyákat kínálja. Csak az adóügyi nyugták országhoz kötöttek.

Miért nem látom a Make-et és a Zapiert?

White Label vállalkozásnak nem jelennek meg. Az API-kulcsai és a webhookjai ugyanúgy működnek.

Poster

A Poster a mi alkalmazásunk a Poster piacterén. A Telepítés a Posterben megnyitja az alkalmazás oldalát, és az alkalmazás egy személyzeti bejelentkezés API-kulcsával állítható be. A pecsétjei ennek a személyzeti bejelentkezésnek a Card Operations keretébe számítanak.

Hogyan csatlakoztathatom a Postert?

Nyisd meg az Integrációk → Poster pontot, és válaszd a Telepítés a Posterben lehetőséget. Az alkalmazás egy személyzeti bejelentkezés API-kulcsával állítható be.

Kinek a Card Operations keretét használják a Poster pecsétjei?

Annak a személyzeti bejelentkezésnek a keretét, amelynek API-kulcsát az alkalmazás használja.

Kell API-kulcs a Posterhez?

Igen, egy személyzeti bejelentkezés API-kulcsa.

Toast

A Toast minden vállalkozásnál Hamarosan érkezik feliratot mutat, amíg a Toast-hozzáférést be nem állítják a platformon. Ez egyetlen kapcsoló az egész platformra, nem a vállalkozás beállítása; ha be van kapcsolva, a Toast kártya magában foglalja a beállítást.

Minden Toast-helyszín a GUID-ja alapján egy személyzeti bejelentkezéshez csatlakozik, API-kulcs nélkül: ennek a személyzeti bejelentkezésnek a vállalkozása, pecsétkártyája és csomagja vonatkozik a helyszín minden Toast-kérésére. Egy helyszín csak egy személyzeti bejelentkezéshez csatlakoztatható, és egy személyzeti bejelentkezéshez egy helyszín tartozik. A helyszín kéréseit elutasítjuk, ha leválasztották, vagy amíg a személyzeti bejelentkezése ki van kapcsolva vagy törölve van.

Minden utalványhoz hozzárendelhető egy Toast-menütétel: a Toast POS-nál ekkor arra a termékre szóló kedvezménnyé válik. A hozzárendelés nélküli utalvány nulla összegű kedvezményként kerül a blokkra, és a pénztáros kézzel adja át az ajándékot. Az utalványokat a Toast POS-nál váltják be, és a fizetett blokkal elért kerék azonnal megpörög. Ha a Toast visszavon egy tranzakciót, a pecsétjeit visszavesszük, illetve a beváltott utalványait visszaállítjuk.

A vendég egy Toast-kioszknál vagy vendégoldali kijelzőn telefonszámmal vagy e-mail-címmel csatlakozhat. A pecsétkártya azonnal kiadásra kerül; a vendég semmit sem kap a 7Stamptől, amíg meg nem nyitja ugyanazzal a telefonszámmal vagy e-mail-címmel.

Miért mutatja a Toast, hogy Hamarosan érkezik?

A Toast-hozzáférés egyetlen kapcsoló az egész platformra, nem a vállalkozásod beállítása. Amíg nincs bekapcsolva, nincs mit csatlakoztatni.

Hogyan csatlakozik egy Toast-helyszín?

A GUID-ja alapján egy személyzeti bejelentkezéshez, API-kulcs nélkül. Ennek a személyzeti bejelentkezésnek a pecsétkártyája és csomagja vonatkozik a helyszín minden kérésére.

Mi történik a pecsétekkel, ha a Toast stornóz egy blokkot?

Ha a Toast visszavon egy tranzakciót, a pecsétjeit visszavesszük, illetve a beváltott utalványait visszaállítjuk.

SmartKasa

SmartKasa az Integrációk lapon

A SmartKasa rendszerhez nem kell API-kulcs. Ez egy nyugtaforrás a „Nyugtaszkennelés” részben, SmartKasa-üzletazonosítóval vagy – az összes üzlet lefedéséhez – a cégkóddal adható hozzá. A vásárlók a SmartKasa-nyugtát a vállalkozás csevegőrobotjában szkennelik be, a pecsétek pedig az adott nyugtaforrás személyzeti bejelentkezéséhez kerülnek.

A SmartKasa ukrán rendszer, az adóügyi nyugták pedig csak Ukrajnában, Szlovákiában, Kazahsztánban és Üzbegisztánban működnek.

Kell API-kulcs a SmartKasa rendszerhez?

Nem. A SmartKasa egy nyugtaforrás a „Nyugtaszkennelés” részben, üzletazonosítóval vagy a cégkóddal adható hozzá.

Hol szkennelik be a vásárlók a SmartKasa-nyugtát?

A vállalkozásod csevegőrobotjában. A pecsétek az adott nyugtaforrás személyzeti bejelentkezéséhez kerülnek.

Mely országokban működnek az adóügyi nyugták?

Ukrajnában, Szlovákiában, Kazahsztánban és Üzbegisztánban.

Make és Zapier

Make az Integrációk lapon

A Make-hez készült 7Stamp alkalmazás a Make nyilvános alkalmazáskönyvtárában van: keress rá a 7Stampre bármelyik Make-forgatókönyvben, vagy használd a Megnyitás Make-ben gombot az Integrációk lapon. A Zapier-alkalmazásunk nincs benne a Zapier nyilvános katalógusában: a Megnyitás Zapierben egy meghívás, amely a vállalkozás saját Zapier-fiókjához adja hozzá az alkalmazást. Mindkét alkalmazás egy személyzeti bejelentkezés API-kulcsával működik.

A Make-forgatókönyveket és a Zapeket a 7Stamp webhookjai indítják, ezért a triggerekhez a Webhooks & Events kiegészítő kell. Az olyan műveletekhez, mint a pecsétek hozzáadása vagy egy utalvány kiadása, csak API-kulcs kell. A Make-et és a Zapiert nem kínáljuk White Label vállalkozásnak.

Hol találom a 7Stamp alkalmazást a Make-ben és a Zapierben?

A Make-ben bármelyik forgatókönyvben keress rá a 7Stampre – az alkalmazás a Make nyilvános alkalmazáskönyvtárában van. A Zapierben még nem nyilvános, ezért használd a Megnyitás Zapierben gombot az Integrációk lapon – a meghívás a saját fiókodhoz adja hozzá az alkalmazást.

Kell a Make-hez és a Zapierhez a Webhooks & Events kiegészítő?

A triggerekhez igen, mert a forgatókönyveket és a Zapeket a 7Stamp webhookjai indítják. Az olyan műveletekhez, mint a pecsétek hozzáadása vagy egy utalvány kiadása, csak API-kulcs kell.

Kell API-kulcs a Make-hez vagy a Zapierhez?

Igen. Az alkalmazások egy személyzeti bejelentkezés API-kulcsával működnek.

Referencia
Működés 2026. október 28.

Csomagok és számlázás

A három csomag, mi a Card Operation, mi számít bele és mi ingyenes, kiegészítők, Access Code-ból származó Packages, és mi történik sikertelen fizetéskor.

Frissítve: 2026. október 28.

Cikk megnyitása
Referencia
Működés 2026. október 28.

Személyzeti hozzáférés

Mi a személyzeti bejelentkezés, hogyan lehet létrehozni, módosítani, kikapcsolni és törölni, hogyan jelentkezik be a személyzet a 7Stamp Scanner alkalmazásba, mit tehet ott, és ki használja az adminisztrációs panelt.

Frissítve: 2026. október 28.

Cikk megnyitása
Referencia
Működés 2026. október 28.

Vásárlók és előzmények

A vásárlók pecsétkártyáinak listája, egy vásárló kártyaoldala, a kártya törlése, az eseménynapló, mit őriz meg a 7Stamp egy vásárlóról, és hogyan törlődnek egy vásárló adatai.

Frissítve: 2026. október 28.

Cikk megnyitása