API és integrációk

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

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

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ény | Mikor küldjük |
|---|---|
SCAN | Egy 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_INSERT | Egy 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_SCAN | Egy 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_JOINED | Egy vásárló új pecsétkártyát kap, bármilyen módon, az általad átadott external_id értékkel |
REWARD_EARNED | Egy szkennelés elér egy Award-célt |
VOUCHER_ISSUED | Egy szkennelés elér egy utalványcélt |
LOTTERY_WIN | Egy Lottery-kereket megpörgetnek, és az nyereményt ad |
VOUCHER_PACK | Egy új kártya megkapja a pecsétkártya utalványcsomagját, az összes utalványát egy eseményben |
ADMIN_VOUCHER_ISSUE | Egy utalványt közvetlenül egy kártyára adnak ki, az adminban vagy az API-n keresztül |
VOUCHER_REDEEMED | Egy 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_CAMPAIGN | Egy kampány eléri a kártyát, kártyánként egyszer, a kampány utalványával, ha van |
BIRTHDAY_GREETING | Kimegy a születésnapi köszöntő a kártyára, a születésnapi utalvánnyal, ha kiadtak ilyet |
AUTO_MESSAGE_VOUCHER | Egy 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_WALLET | A kártyát hozzáadják az Apple Wallet-hez vagy a Google Wallet-hez |
CARD_REMOVED_FROM_WALLET | A 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 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.

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

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

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.