Референца Операције

API, вебхукови и интеграције

API кључеви за пријаве запослених, шта ради API, Webhooks и њихови догађаји, садржај, потпис и поновни покушаји, и готове интеграције: Poster, Toast, SmartKasa, Make и Zapier.

Quick read

Updated: 19. новембар 2026.

API и интеграције

API кључеви у одељку API и интеграције

Подешавања → API и интеграције има три картице: API кључеви, Webhooks и Интеграције.

API и API кључеви су бесплатни на сваком плану, укључујући Free Forever; не постоји API додатак. Печати дати преко API су Card Operations као и сви други, па престају када се Card Operations из плана потроше. Webhooks су плаћени део, видите у наставку.

Да ли API кошта додатно?

Не. API и API кључеви су бесплатни на сваком плану, укључујући Free Forever. Печати дати преко њега су Card Operations као и сви други.

Могу ли да користим API на Free Forever?

Да. Када се Card Operations плана потроше, печати преко API престају као и сви други.

Где су подешавања API?

У Подешавања → API и интеграције, са три картице — API кључеви, Webhooks и Интеграције.

API кључеви

Генериши API кључ за пријаву запослених

API кључ се прави у API кључеви → Додај API кључ за једну пријаву запослених. Пријава запослених има највише један API кључ, а искључена пријава запослених не може да се изабере. Када нема пријаве запослених за избор, прозор Генериши API кључ нуди да је направите на лицу места; нова пријава запослених захтева слободно Staff Seat, а на пуном плану прозор уместо тога нуди додавање места или избор плана.

Сваки позив упућен са API кључем делује као његова пријава запослених: стиже само до предузећа те пријаве запослених, печатира картицу са печатима изабрану за њу под Аутоматско штанцање, а његови печати се рачунају као Card Operations те пријаве запослених.

Кључ може да се погледа и копира у било ком тренутку са листе API кључева. Може да се прикаже и као QR код, да се скенира у терминал, и да се одштампа са називом пријаве запослених.

Како да направим API кључ?

У Подешавања → API и интеграције → API кључеви изаберите Додај API кључ и изаберите пријаву запослених. Свака пријава запослених има највише један API кључ.

Изгубио сам API кључ. Да ли ми треба нови?

Не. Кључ се у било ком тренутку може поново видети и копирати са листе API кључева, или приказати као QR код.

Коју картицу са печатима печатирају API позиви?

Ону која је изабрана за пријаву запослених тог кључа под Аутоматско штанцање. Њени печати се рачунају као Card Operations те пријаве запослених.

Зашто не могу да изаберем пријаву запослених за нови кључ?

Искључена пријава запослених не може да се изабере, а пријава запослених која већ има кључ не може да добије други. Када нема ниједне за избор, прозор нуди прављење пријаве запослених.

Када API кључ престане да ради

API кључ не истиче. Престаје да ради само када се поново генерише или обрише, или када се његова пријава запослених искључи или обрише. Нова лозинка или ново корисничко име пријаве запослених не утичу на њега.

  • Поново генериши даје пријави запослених нови API кључ; стари одмах престаје да ради.
  • Обриши одмах зауставља кључ. Сама пријава запослених наставља да ради у 7Stamp Scanner и касније може да добије нови кључ.
  • Искључивање пријаве запослених задржава њен кључ: када се пријава запослених поново укључи, исти кључ поново ради.

Да ли API кључ истиче?

Не. Престаје да ради само када се поново генерише или обрише, или када се његова пријава запослених искључи или обрише.

Променио сам лозинку пријаве запослених. Да ли ми треба нови API кључ?

Не. Нова лозинка или ново корисничко име не утичу на API кључ.

Поново сам укључио пријаву запослених. Да ли њен стари API кључ ради?

Да. Искључивањем пријаве запослених кључ се задржава, а исти кључ поново ради када се она опет укључи.

Шта ради API

Преко API систем може да:

  • подели картицу са печатима као везу или QR;
  • додаје печате;
  • чита картицу са печатима, циљевима и ваучерима;
  • издаје ваучер директно на картицу;
  • искоришћава ваучер помоћу његовог кода ваучера;
  • шаље поруку купцу.

API проналази картицу купца по сопственом идентификатору предузећа, као што је CRM ID, телефон или имејл, послатом као external_id. Идентификатор се чува на картици и враћа се у сваком Webhook-у о њој. API нема позив који наводи купце предузећа: цела база купаца добија се само извозом из администратора.

Уместо API кључа, апликација може да се пријави корисничким именом и лозинком пријаве запослених — за уређај на који се пријављује касир. API кључ одговара уређају који ради без надзора. Webhooks се додају само у администратору; API нема позив за претплату на догађаје нити за њихово листање.

API не поставља ограничење учесталости захтева: позиви се не ограничавају по броју или учесталости, а иста картица може одмах поново да се скенира. Печатирање преко њега ограничава квота Card Operations из плана.

Можемо ли да додајемо печате из сопственог CRM или POS?

Да, преко API. Он издаје картице са печатима, додаје печате, чита картице и искоришћава ваучере. Да би ваш систем био обавештаван о догађајима, додајте Webhook — за то је потребан додатак Webhooks & Events.

Можемо ли да извеземо податке?

Преко API читате картице по сопственом идентификатору, а Webhooks шаљу догађаје како се дешавају. API нема листу свих купаца — цела база купаца добија се извозом из администратора.

Како API проналази картицу купца?

По вашем сопственом идентификатору — CRM ID, телефону или имејлу — који се шаље као external_id. Чува се на картици и враћа се у сваком Webhook-у о њој.

Могу ли да се претплатим на Webhooks преко API?

Не. Webhooks се додају само у администратору.

Да ли API има ограничење учесталости позива?

Не. Позиви се не ограничавају по броју или учесталости, а иста картица може одмах поново да се скенира. Печатирање је ограничено само квотом Card Operations из плана.

API референца

API референца је јавна и не захтева пријаву: Swagger на https://api.7loc.com/cards-api/docs, са OpenAPI датотеком на https://api.7loc.com/cards-api/openapi.json. Позиви иду на https://api.7loc.com/cards-api и потребан им је API кључ или пријава запослених.

Предузеће са White Label не види у администратору везу ка API референци. Његови API кључеви и Webhooks раде исто.

Где је API документација?

Swagger на https://api.7loc.com/cards-api/docs, јавно, без потребе за пријавом. OpenAPI датотека је на https://api.7loc.com/cards-api/openapi.json.

Која је основна адреса за API позиве?

https://api.7loc.com/cards-api. За позиве је потребан API кључ или пријава запослених.

Наш White Label администратор нема везу ка API документацији. Да ли API ради за нас?

Да. Предузеће са White Label не види везу ка референци, али његови API кључеви и Webhooks раде исто.

Webhooks

Webhooks у одељку API и интеграције

Webhook се додаје у API и интеграције → Webhooks → Додај webhook, са URL који прима догађаје. У 7Stamp Webhook се креира за догађаје картице са печатима. Предузеће може да дода више Webhooks, сваки са својим URL.

За Webhooks је потребан додатак Webhooks & Events, €19 месечно, који се нуди само на плаћеним плановима. Додавање првог Webhook-а нуди куповину додатка; без њега Webhook не може да се направи нити поново укључи. Један додатак одржава један Webhook укључен: може се додати још, али свако ажурирање наплате претплате искључује све осим најстаријег.

Webhooks шаљу догађаје како се дешавају од тренутка када је Webhook додат. Ранији догађаји се не шаљу.

Да ли су Webhooks бесплатни?

Не. Потребан им је додатак Webhooks & Events, €19 месечно, који се нуди само на плаћеним плановима. Сам API је бесплатан.

Додао сам други Webhook и он је био искључен. Зашто?

Један додатак Webhooks & Events одржава један Webhook укључен. Свако ажурирање наплате претплате искључује све осим најстаријег.

Да ли ће нови Webhook слати прошле догађаје?

Не. Догађаји се шаљу од тренутка када је Webhook додат.

Догађаји Webhook-а

Webhook добија петнаест догађаја картице са печатима, наведених у 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 и CARD_REMOVED_FROM_WALLET. Последња два стижу када се пропусница дода у новчаник или уклони из њега, уз новчаник, Apple или Google.

Скенирање које не додаје печат, као што је куповина испод цене печата, и даље шаље SCAN са нула додатих печата. Добитак освојен на точку објављује један LOTTERY_WIN када се точак заврти, а не REWARD_EARNED или VOUCHER_ISSUED; точак који чека на окретање још ништа не шаље.

Рецензије купаца нису догађаји картице са печатима. Свака нова рецензија шаље догађај са ентитетом review и радњом created, на Webhooks који имају означене Рецензије међу својим објектима на страници Webhook-а. Webhook додат овде подешен је само за догађаје картице са печатима, па рецензије добија када се означи Рецензије.

Да ли се Webhook шаље када скенирање не дода печат?

Да. Скенирање које не додаје печат, као што је куповина испод цене печата, и даље шаље SCAN са нула додатих печата.

Који догађај ми јавља да је купац победио на точку?

LOTTERY_WIN, шаље се једном када се точак заврти. Точак који чека на окретање још ништа не шаље.

Могу ли да сазнам када купац уклони картицу из свог новчаника?

Да. Додавање пропуснице у новчаник и њено уклањање шаљу CARD_ADDED_TO_WALLET и CARD_REMOVED_FROM_WALLET, са новчаником, Apple или Google.

Како да добијам нове рецензије купаца преко Webhook?

Отворите страницу Webhook-а и означите Рецензије међу његовим објектима. Свака нова рецензија тада стиже са ентитетом review и радњом created; Webhook додат у одељку API и интеграције до тада добија само догађаје картице са печатима.

Када се шаље сваки догађај

ДогађајШаље се када
SCANПријава запослених скенира картицу: у 7Stamp Scanner, преко API или са POS као што је Toast. Печати уклоњени у 7Stamp Scanner су SCAN са негативним stamps_added
DELIVERY_INSERTКупац отвара Код печата који даје печате — QR, везу, сам код или позивницу направљену преко API
RECEIPT_SCANКупац скенира фискални рачун у чет-боту предузећа и он се печатира; amount је укупан износ рачуна
CARD_JOINEDКупац добија нову картицу са печатима, на било који начин, са external_id који сте проследили
REWARD_EARNEDСкенирање достиже циљ типа Award
VOUCHER_ISSUEDСкенирање достиже циљ типа ваучер
LOTTERY_WINТочак Lottery се заврти и даје награду
VOUCHER_PACKНова картица добија пакет ваучера картице са печатима, све њене ваучере у једном догађају
ADMIN_VOUCHER_ISSUEВаучер се издаје директно на картицу, у администратору или преко API
VOUCHER_REDEEMEDВаучер на картици се искоришћава: у 7Stamp Scanner, преко API, на Toast POS или од стране купца
CARD_CAMPAIGNКампања стиже до картице, једном по картици, са ваучером Кампање ако га има
BIRTHDAY_GREETINGРођенданска честитка се шаље за картицу, са Рођенданским ваучером ако је издат
AUTO_MESSAGE_VOUCHERОкидач Аутоматске поруке ставља ваучер на картицу, без обзира на то да ли канал тада допире до купца
CARD_ADDED_TO_WALLETПропусница се додаје у Apple Wallet или Google Wallet
CARD_REMOVED_FROM_WALLETПропусница се уклања из новчаника

Сваки циљ који скенирање достигне шаље свој догађај након догађаја скенирања, а циљ достигнут двапут једним скенирањем, током два круга картице, шаље два. Пуна картица која започиње нови круг је иста картица и не шаље CARD_JOINED; картица издата поново након што је администратор обрисао стару шаље. Када придруживање доноси пакет ваучера и печате, прво стиже CARD_JOINED, затим VOUCHER_PACK, затим DELIVERY_INSERT.

Код печата без печата не шаље DELIVERY_INSERT, ваучер генерисан у администратору без картице не шаље ADMIN_VOUCHER_ISSUE, а поновљен API позив за ваучер који је већ искоришћен не шаље други VOUCHER_REDEEMED.

Који догађај ми јавља да је купац достигао циљ?

REWARD_EARNED за циљ типа Award, VOUCHER_ISSUED за циљ типа ваучер и LOTTERY_WIN за Lottery, сваки послат после сопственог догађаја скенирања.

Да ли се Webhook шаље када се печати уклоне?

Да. Печати уклоњени у 7Stamp Scanner стижу као SCAN са негативним stamps_added.

Која је разлика између VOUCHER_ISSUED и ADMIN_VOUCHER_ISSUE?

VOUCHER_ISSUED стиже када скенирање достигне циљ типа ваучер. ADMIN_VOUCHER_ISSUE стиже када се ваучер издаје директно на картицу, ручно у администратору или преко API.

Шаље ли купац који се придружи уз Код печата један догађај или више?

Више. Прво стиже CARD_JOINED, затим VOUCHER_PACK ако картица са печатима има пакет ваучера, затим DELIVERY_INSERT са печатима.

Добијам ли догађај за сваку поруку Кампање?

CARD_CAMPAIGN се шаље једном за сваку картицу до које Кампања стигне, са ваучером Кампање када га носи.

Шта Webhook прима

Сваки догађај има исто JSON тело: ID догађаја, предузеће и догађај са својим типом, картицу са печатима, печате пре и после, износ куповине, ID поруџбине и external_id које је интеграција послала, пријаву запослених која је услужила, ваучере и награде које је дао, и име купца, имејл, Telegram, WhatsApp телефон и датум рођења.

amount је износ куповине у најмањим јединицама (центима): износ 12,50 послат уз скенирање стиже као 1250. Празан је када догађај није имао износ.

ID догађаја налази се у телу и у заглављу X-Webhook-Event-Id. Поновни покушај истог догађаја задржава његов ID, па прималац може да одбаци дупликате. За Make или Zapier URL догађај се налази под кључем card_event уместо data.

Које податке о купцу носи Webhook?

Име, имејл, Telegram, WhatsApp телефон и датум рођења, заједно са картицом са печатима, печатима пре и после, и издатим ваучерима и наградама.

У којој јединици је износ?

У најмањим јединицама (центи). Износ 12,50 послат уз скенирање стиже као 1250; празан је када догађај није имао износ.

Како да избегнем двоструку обраду истог догађаја?

Користите ID догађаја, у телу и у заглављу X-Webhook-Event-Id. Поновни покушај задржава исти ID.

Зашто је догађај у Make под card_event?

За Make или Zapier URL догађај се налази под кључем card_event уместо data, да би их њихове апликације могле разликовати.

Потпис

Свака испорука је потписана. Заглавље X-Webhook-Signature садржи временску ознаку и HMAC-SHA256 те временске ознаке и необрађеног тела, са тајним кључем Webhook-а. Тајни кључ се приказује и поново генерише на страници Webhook-а. Могу се додати и Basic auth корисничко име и лозинка.

Како да проверим да Webhook заиста долази од 7Stamp?

Израчунајте HMAC-SHA256 временске ознаке и необрађеног тела помоћу тајног кључа Webhook-а и упоредите га са заглављем X-Webhook-Signature.

Где да пронађем тајни кључ Webhook-а?

На страници Webhook-а, где може и да се поново генерише.

Могу ли да заштитим свој endpoint лозинком?

Да. Webhook-у се, поред потписа, могу додати Basic auth корисничко име и лозинка.

Неуспеле испоруке

Испорука која у року од тридесет секунди не добије 2xx одговор поново се покушава до десет пута, при чему је свако чекање четири секунде дуже од претходног, па се поновни покушаји завршавају за око четири минута. Одговор 429 са Retry-After поново се покушава после тог времена. Први неуспех догађаја ставља обавештење у администратор.

После сто неуспешних испорука заредом систем блокира Webhook и он више не добија догађаје. Његова страница упозорава пре тога и има дугме Деблокирај; једна успешна испорука ресетује бројање.

Страница сваког Webhook-а има дневник његових испорука, са послатим захтевом и примљеним одговором. Пошаљи поново поново шаље исти догађај, само овом Webhook-у.

Мој сервер није радио. Да ли су догађаји изгубљени?

Свака испорука се понавља до десет пута у року од око четири минута. После тога отворите дневник Webhook-а и употребите Пошаљи поново за догађаје који су вам потребни.

Зашто је мој Webhook престао да прима догађаје?

После сто неуспешних испорука заредом систем га блокира. Поправите endpoint и притисните Деблокирај на страници Webhook-а.

Могу ли да видим шта је послато на мој Webhook?

Да. Страница сваког Webhook-а има дневник испорука са послатим захтевом и примљеним одговором.

Картица Интеграције

Картица Интеграције

Картица Интеграције наводи готове начине по групама:

  • Печатирање на каси — Poster, Toast, Ваш сопствени POS или CRM и Не видите свој POS?;
  • Фискални рачуни — SmartKasa;
  • Аутоматизација — Make, Zapier и Public Swagger.

Свака картица наводи да ли захтева API кључ. Картица Интеграције нуди исте картице у свакој држави; само су фискални рачуни ограничени по држави.

Ваш POS или CRM

Предузеће са White Label не види картице Make, Zapier ни Public Swagger и не нуди му се Poster нити водичи за подешавање на 7stamp.com.

Који POS системи су спремни за повезивање?

Poster, и Toast када се укључи за платформу — дотле приказује Ускоро. Остали системи се повезују преко API, уз Ваш сопствени POS или CRM.

Да ли су интеграције ограничене по држави?

Не. Картица нуди исте картице у свакој држави. Само су фискални рачуни ограничени по држави.

Зашто не видим Make и Zapier?

Не приказују се предузећу са White Label. Његови API кључеви и Webhooks раде исто.

Poster

Poster је наша апликација на Poster маркетплејсу. Инсталирај у Poster отвара њену страницу, а апликација се подешава API кључем једне пријаве запослених. Њени печати се рачунају као Card Operations те пријаве запослених.

Како да повежем Poster?

Отворите Интеграције → Poster и изаберите Инсталирај у Poster. Апликација се подешава помоћу API кључа једне пријаве запослених.

Чије Card Operations троше печати из Poster?

Оне пријаве запослених чији API кључ апликација користи.

Да ли ми је потребан API кључ за Poster?

Да, API кључ једне пријаве запослених.

Toast

Toast приказује Ускоро за свако предузеће док се приступ за Toast не подеси на платформи. То је један прекидач за целу платформу, а не подешавање предузећа; када је укључен, сама картица Toast садржи подешавање.

Свака Toast локација је повезана својим GUID са једном пријавом запослених, без API кључа: предузеће, картица са печатима и план те пријаве запослених важе за сваки Toast захтев са локације. Локација може да буде повезана само са једном пријавом запослених, а једна пријава запослених садржи једну локацију. Захтеви са локације се одбијају када се она искључи, или док је њена пријава запослених искључена или обрисана.

Сваком ваучеру може да се додели Toast производ из менија: на Toast POS он тада постаје попуст на тај производ. Ваучер без њега примењује се као нулти попуст на рачуну, а касир поклон уручује ручно. Ваучери се искоришћавају на Toast POS, а точак који је достигао плаћен рачун одмах се врти. Када Toast поништи трансакцију, њени печати се одузимају или се њени искоришћени ваучери враћају.

Гост може да се придружи на Toast киоску или екрану окренутом гостима уз број телефона или имејл. Картица са печатима се издаје одмах; гост не добија ништа од 7Stamp док је не отвори истим телефоном или имејлом.

Зашто Toast приказује Ускоро?

Приступ за Toast је један прекидач за целу платформу, а не подешавање вашег предузећа. Док није укључен, нема шта да се повезује.

Како се повезује Toast локација?

Преко свог GUID са једном пријавом запослених, без API кључа. Картица са печатима и план те пријаве запослених важе за сваки захтев са локације.

Шта се дешава са печатима када Toast поништи рачун?

Када Toast поништи трансакцију, њени печати се одузимају или се њени искоришћени ваучери враћају.

SmartKasa

SmartKasa на картици Интеграције

SmartKasa не захтева API кључ. То је извор рачуна у одељку Скенирање рачуна, који се додаје преко SmartKasa ID продавнице или шифре компаније да обухвати све продавнице. Купци скенирају SmartKasa рачун у чет-боту предузећа, а печати иду на пријаву запослених тог извора рачуна.

SmartKasa је украјинска, а фискални рачуни раде само у Украјини, Словачкој, Казахстану и Узбекистану.

Да ли ми је потребан API кључ за SmartKasa?

Не. SmartKasa је извор рачуна у одељку Скенирање рачуна, који се додаје преко ID продавнице или шифре компаније.

Где купци скенирају SmartKasa рачун?

У чет-боту вашег предузећа. Печати иду на пријаву запослених тог извора рачуна.

У којим државама раде фискални рачуни?

У Украјини, Словачкој, Казахстану и Узбекистану.

Make и Zapier

Make на картици Интеграције

Апликација 7Stamp за Make налази се у јавном каталогу апликација Make: потражите 7Stamp у било ком Make сценарију или користите Отвори у Make на картици Интеграције. Наша апликација за Zapier није у јавном директоријуму Zapier: Отвори у Zapier је позивница која додаје апликацију на Zapier налог самог предузећа. Обе апликације раде са API кључем једне пријаве запослених.

Make сценарије и Zaps покрећу Webhooks из 7Stamp, па окидачи захтевају додатак Webhooks & Events. За радње као што су додавање печата или издавање ваучера потребан је само API кључ. Make и Zapier се не нуде предузећу са White Label.

Где да нађем апликацију 7Stamp у Make и Zapier?

У Make потражите 7Stamp у било ком сценарију — апликација је у јавном каталогу апликација Make. У Zapier још није јавна, па користите Отвори у Zapier на картици Интеграције — позивница додаје апликацију на ваш налог.

Да ли су Make и Zapier потребан додатак Webhooks & Events?

За окидаче јесте, јер сценарије и Zaps покрећу Webhooks из 7Stamp. За радње као што су додавање печата или издавање ваучера потребан је само API кључ.

Да ли ми је потребан API кључ за Make или Zapier?

Да. Апликације раде са API кључем једне пријаве запослених.

Референца
Операције 28. октобар 2026.

Планови и наплата

Три плана, шта је Card Operation, шта се рачуна а шта је бесплатно, додаци, Packages из Access Code и шта се дешава када плаћање не прође.

Updated: 28. октобар 2026.

Отвори чланак
Референца
Операције 28. октобар 2026.

Приступ запослених

Шта је пријава запослених, како да је направите, измените, искључите и обришете, како се особље пријављује у 7Stamp Scanner, шта тамо може да ради и ко користи административни панел.

Updated: 28. октобар 2026.

Отвори чланак
Референца
Операције 28. октобар 2026.

Купци и историја

Листа картица са печатима купаца, страница картице купца, брисање картице, Дневник догађаја, шта 7Stamp чува о купцу и како се бришу подаци купца.

Updated: 28. октобар 2026.

Отвори чланак