API & integrationer

Inställningar → API & integrationer har tre flikar: API-nycklar, Webhooks och Integrations.
Nycklarna API och API är gratis på alla plan, inklusive Free Forever; det finns inget API-tillägg. Stämplar som ges genom API är Card Operations som alla andra, så de slutar när planens Card Operations tar slut. Webhooks är den betalda delen, se nedan.
Kostar API extra?
Nej. Nycklarna API och API är gratis på alla plan, inklusive Free Forever. Stämplar som ges genom den är Card Operations som alla andra.
Kan jag använda API på Free Forever?
Ja. När planens Card Operations tar slut stannar stämplarna genom API som alla andra.
Var finns API-inställningarna?
I Inställningar → API & integrationer, med tre flikar — API-nycklar, Webhooks och Integrationer.
API nycklar

En API-nyckel skapas under API-nycklar → Lägg till API-nyckel för en personalinloggning. En personalinloggning har högst en API-nyckel, och en avstängd personalinloggning kan inte väljas. Utan någon personalinloggning att välja, erbjuder nyckelfönstret Generate API att skapa en där; en ny personalinloggning behöver en gratis Staff Seat, och på en full plan erbjuder fönstret att lägga till en plats eller välja en plan istället.
Varje samtal som görs med en API-nyckel fungerar som dess personalinloggning: den når endast personalinloggningens företag, stämplar stämpelkortet som valts för det under Automatisk stämpling, och dess stämplar räknas som personalinloggningens Card Operations.
Nyckeln kan ses och kopieras igen när som helst från API-nyckellistan. Den kan också visas som en QR-kod för att skanna den till en terminal och skrivas ut med personalinloggningens namn.
Hur skapar jag en API-nyckel?
I Inställningar → API & integrationer → API-nycklar, välj Lägg till API-nyckel och välj en personalinloggning. Varje personalinloggning har högst en API-nyckel.
Jag tappade min API-nyckel. Behöver jag en ny?
Nej. Nyckeln kan visas och kopieras igen när som helst från API-nyckellistan, eller visas som en QR-kod.
Vilket stämpelkort kallar API stämpel?
Den som valts för nyckelns Personalinloggning under Automatisk stämpling. Dess stämplar räknas som personalinloggningens Card Operations.
Varför kan jag inte välja en personalinloggning för en ny nyckel?
En avstängd personalinloggning kan inte väljas, och en personalinloggning som redan har en nyckel kan inte få en andra. Med ingen att välja, erbjuder fönstret att skapa en personalinloggning.
När en API-nyckel slutar fungera
En API-nyckel upphör inte att gälla. Den slutar fungera endast när den återskapas eller tas bort, eller när dess personalinloggning stängs av eller tas bort. Ett nytt lösenord eller inloggning för personalinloggningen påverkar inte det.
- Regenerate ger personalinloggningen en ny API-nyckel; den gamla slutar fungera på en gång.
- Delete stoppar nyckeln på en gång. Själva personalinloggningen fortsätter att fungera i 7Stamp Scanner och kan få en ny nyckel senare.
- Att stänga av en personalinloggning behåller dess nyckel: när personalinloggningen slås på igen, fungerar samma nyckel igen.
Upphör en API-nyckel?
Nej. Den slutar fungera först när den återskapas eller tas bort, eller när dess personalinloggning stängs av eller tas bort.
Jag ändrade personalinloggningens lösenord. Behöver jag en ny API-nyckel?
Nej. Ett nytt lösenord eller inloggning påverkar inte API-nyckeln.
Jag slog på en personalinloggning igen. Fungerar den gamla API-nyckeln?
Ja. Att stänga av en personalinloggning behåller dess nyckel, och samma nyckel fungerar igen när den är på igen.
Vad API gör
Genom API kan ett system:
- dela ut ett stämpelkort som länk eller QR;
- lägg till stämplar;
- läsa ett kort med dess stämplar, mål och kuponger;
- utfärda en kupong direkt till ett kort;
- lösa in en kupong med dess kupongnummer;
- meddelande till en köpare.
API hittar en köpares kort med företagets egen identifierare, såsom ett CRM ID, telefon eller e-post, skickat som external_id. Identifieraren lagras på kortet och kommer tillbaka i varje Webhook om det. API har inget anrop som listar ett företags köpare: hela köparbasen tas ut endast genom adminexporten.
Istället för en API-nyckel kan en app logga in med en personalinloggningsinloggning och lösenord – för en enhet som en kassörska loggar in på. En API-nyckel passar en enhet som körs obevakad. Webhooks läggs endast till i admin; API har inget samtal för att prenumerera på händelser eller lista dem.
API anger ingen gräns för begäranden: samtal stryps inte av antal eller frekvens, och samma kort kan skannas igen direkt. Det som begränsar stämplingen genom den är planens Card Operations.
Kan vi lägga till stämplar från vår egen CRM eller POS?
Ja, genom API. Den delar ut stämpelkort, lägger till stämplar, läser kort och löser in kuponger. För att få ditt system att berätta om händelser, lägg till en Webhook - som behöver tillägget Webhooks & Events.
Kan vi exportera data?
Genom API läser du kort med din egen identifierare, och Webhooks skickar händelser när de inträffar. API har ingen lista över alla köpare – hela köparbasen tas ut genom adminexporten.
Hur hittar API en köpares kort?
Med din egen identifierare – ett CRM ID, telefon eller e-post – skickas som external_id. Det lagras på kortet och kommer tillbaka i varje Webhook om det.
Kan jag prenumerera på Webhooks via API?
Nej. Webhooks läggs endast till i admin.
Har API en hastighetsgräns?
Nej. Samtal stryps inte av nummer eller frekvens, och samma kort kan skannas igen direkt. Stämpling begränsas endast av planens Card Operations.
API referens
API-referensen är offentlig och behöver ingen inloggning: Swagger på https://api.7loc.com/cards-api/docs, med OpenAPI-filen på https://api.7loc.com/cards-api/openapi.json. Samtal går till https://api.7loc.com/cards-api och behöver en API-nyckel eller en personalinloggning.
En White Label Business ser ingen länk till API-referensen i admin. Dess API-nycklar och Webhooks fungerar på samma sätt.
Var finns API-dokumentationen?
Swagger finns på https://api.7loc.com/cards-api/docs, är offentligt och kräver ingen inloggning. OpenAPI-filen finns på https://api.7loc.com/cards-api/openapi.json.
Vad är basadressen för API-anrop?
https://api.7loc.com/cards-api. Samtal behöver en API-nyckel eller en personalinloggning.
Vår White Label-admin har ingen API-dokumentlänk. Fungerar API för oss?
Ja. En White Label Business ser ingen länk till referensen, men dess API-nycklar och Webhooks fungerar på samma sätt.
Webhooks

En Webhook läggs till under API & integrationer → Webhooks → Lägg till webhook, med URL som tar emot händelserna. I 7Stamp skapas en Webhook för stämpelkorthändelser. Ett företag kan lägga till flera Webhooks, var och en med sin egen URL.
Webhooks behöver Webhooks & Events-tillägget, €19 en månad, som endast erbjuds på betalplaner. Att lägga till den första Webhook erbjuder att köpa den; utan den kan en Webhook inte skapas eller slås på igen. Ett tillägg håller en Webhook påslagen: fler kan läggas till, men varje faktureringsuppdatering av prenumerationen stänger av alla utom den äldsta.
Webhooks skickar händelser när de inträffar från det ögonblick som Webhook läggs till. Tidigare händelser skickas inte.
Är Webhooks gratis?
Nej. De behöver Webhooks & Events-tillägget, €19 per månad, som endast erbjuds på betalplaner. Själva API är gratis.
Jag lade till en andra Webhook och den stängdes av. Varför?
Ett Webhooks & Events-tillägg håller en Webhook påslagen. Varje faktureringsuppdatering av prenumerationen stänger av alla utom den äldsta.
Kommer en ny Webhook att skicka tidigare händelser?
Nej. Händelser skickas från det ögonblick som Webhook läggs till.
Webhook-evenemang
En Webhook får femton stämpelkorthändelser, namngivna i 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 och CARD_REMOVED_FROM_WALLET. De två sista kommer när passet läggs till en plånbok eller tas bort från en, med plånboken, Apple eller Google.
En skanning som inte lägger till någon stämpel, till exempel ett köp under stämpelpriset, skickar fortfarande SCAN med noll stämplar tillagda. Ett pris som vunnits på ett hjul tillkännages av en LOTTERY_WIN när hjulet snurras, inte av REWARD_EARNED eller VOUCHER_ISSUED; ett hjul som väntar på att snurras skickar ingenting ännu.
köparrecensioner är inte stämpelkorthändelser. Varje ny recension skickar en händelse med entitet review och handling created, till de Webhooks som har Recensioner bockade bland sina objekt på Webhooks sida. En Webhook som läggs till här är endast inställd för stämpelkorthändelser, så den får recensioner när recensioner är markerad.
Skickas en Webhook när en skanning inte lägger till någon stämpel?
Ja. En skanning som inte lägger till någon stämpel, till exempel ett köp under stämpelpriset, skickar fortfarande SCAN med noll stämplar tillagda.
Vilken händelse säger mig att en köpare vann på hjulet?
LOTTERY_WIN, skickas en gång när hjulet snurras. Ett hjul som väntar på att snurras skickar ännu ingenting.
Kan jag se när en köpare tar bort kortet från sin plånbok?
Ja. Lägg till passet i en plånbok och ta bort det skicka CARD_ADDED_TO_WALLET och CARD_REMOVED_FROM_WALLET, med plånboken, Apple eller Google.
Hur får jag nya köparrecensioner via en Webhook?
Öppna Webhooks sida och markera Recensioner bland dess objekt. Varje ny recension kommer sedan med enhetsgranskning och åtgärd skapad; en Webhook som läggs till under API & integrationer får endast stämpelkorthändelser fram till dess.
När varje händelse skickas
| Händelse | Skickas när |
|---|---|
SCAN | En personalinloggning skannar kortet: i 7Stamp Scanner, genom API eller från en POS som Toast. Stämplar som tagits bort i 7Stamp Scanner är en SCAN med negativ stamps_added |
DELIVERY_INSERT | En köpare öppnar en stämpelkod som ger stämplar — en QR, en länk, själva koden eller en inbjudan gjord via API |
RECEIPT_SCAN | En köpare skannar ett skattekvitto i företagets chatbot och det stämplas; amount är summan av kvittot |
CARD_JOINED | En köpare får ett nytt stämpelkort, oavsett sätt, med external_id du klarade |
REWARD_EARNED | En skanning når ett Award-mål |
VOUCHER_ISSUED | En skanning når ett kupongmål |
LOTTERY_WIN | Ett Lottery-hjul snurras och ger ett pris |
VOUCHER_PACK | Ett nytt kort får stämpelkortets kupongpaket, alla dess kuponger i ett evenemang |
ADMIN_VOUCHER_ISSUE | En kupong utfärdas direkt till ett kort, i admin eller via API |
VOUCHER_REDEEMED | En kupong på ett kort löses in: i 7Stamp Scanner, via API, på en Toast-POS eller av köparen |
CARD_CAMPAIGN | En kampanj når kortet, en gång per kort, med kampanjkupongen om den har en |
BIRTHDAY_GREETING | Födelsedagshälsningen går ut för kortet, med födelsedagskupongen om en sådan utfärdades |
AUTO_MESSAGE_VOUCHER | En automatisk meddelandeutlösare sätter en kupong på kortet, oavsett om en kanal sedan når köparen eller inte |
CARD_ADDED_TO_WALLET | Passet läggs till Apple Wallet eller Google Wallet |
CARD_REMOVED_FROM_WALLET | Passet tas bort från en plånbok |
Varje mål som en skanning når skickar sin egen händelse efter skanningens ett, och ett mål som nås två gånger av en skanning, över två omgångar av kortet, skickar två. Ett fullt kort som startar en ny runda är samma kort och skickar ingen CARD_JOINED; ett kort som utfärdats igen efter att en administratör tagit bort det gamla gör det. När ett medlemskap ger ett kupongpaket och stämplar kommer CARD_JOINED först, sedan VOUCHER_PACK och sedan DELIVERY_INSERT.
En stämpelkod utan stämplar skickar ingen DELIVERY_INSERT, en kupong genererad i administratören utan ett kort skickar ingen ADMIN_VOUCHER_ISSUE, och ett upprepat API-anrop för en kupong som den redan har löst in skickar ingen andra VOUCHER_REDEEMED.
Vilken händelse säger att en köpare har nått ett mål?
REWARD_EARNED för ett Award-mål, VOUCHER_ISSUED för ett kupong-mål och LOTTERY_WIN för ett Lottery, var och en skickad efter skanningens egen händelse.
Skickas en Webhook när stämplar tas bort?
Ja. Stämplar borttagna i 7Stamp Scanner anländer som SCAN med ett negativt stamps_added.
Vad är skillnaden mellan VOUCHER_ISSUED och ADMIN_VOUCHER_ISSUE?
VOUCHER_ISSUED kommer när en skanning når ett kupongmål. ADMIN_VOUCHER_ISSUE kommer när en kupong utfärdas direkt till ett kort, för hand i admin eller via API.
Skickar en köpare som går med med en stämpelkod ett eller flera evenemang?
Flera. CARD_JOINED kommer först, sedan VOUCHER_PACK om Stämpelkortet har ett värdekupongpaket, sedan DELIVERY_INSERT med stämplarna.
Får jag en händelse för varje kampanjmeddelande?
CARD_CAMPAIGN skickas en gång för varje kort som kampanjen når, med kampanjens kupong när den har ett.
Vad en Webhook tar emot
Varje evenemang har samma JSON-kropp: evenemangs-ID, företaget och evenemanget med dess typ, stämpelkortet, stämplar före och efter, inköpsbeloppet, beställnings-ID och external_id den skickade integrationen, personalinloggningen som serverade den, kupongerna och belöningar den gav, och köparens namn, e-post, Telegram, WhatsApp-telefon och födelsedatum.
amount är inköpsbeloppet i mindre enheter (cent): ett belopp på 12,50 skickat med skanningen kommer till 1250. Det är tomt när händelsen inte hade något belopp.
Händelse-ID:t finns i brödtexten och i X-Webhook-Event-Id-huvudet. Ett nytt försök av samma händelse behåller dess ID, så att en mottagare kan släppa upprepningar. För en Make eller Zapier URL sitter händelsen under card_event-nyckeln istället för data.
Vilken data bär en Webhook om köparen?
Namn, e-post, Telegram, WhatsApp telefon och födelsedatum, tillsammans med stämpelkortet, stämplar före och efter, samt kuponger och belöningar som ges.
I vilken enhet finns mängden?
I mindre enheter (cent). Ett belopp på 12,50 skickat med skanningen anländer som 1250; den är tom när händelsen inte hade något belopp.
Hur undviker jag att behandla samma händelse två gånger?
Använd händelse-ID:t, i brödtexten och i X-Webhook-Event-Id-huvudet. Ett nytt försök behåller samma ID.
Varför är eventet under card_event i Make?
För en Make eller Zapier URL sitter händelsen under card_event-nyckeln istället för data, så att deras appar kan skilja det åt.
Signatur
Varje leverans är signerad. X-Webhook-Signature-huvudet innehåller en tidsstämpel och en HMAC-SHA256 för den tidsstämpeln och den råa kroppen, inkodade med Webhooks hemliga nyckel. Den hemliga nyckeln visas och återskapas på Webhooks sida. En grundläggande autentiseringsinloggning och lösenord kan också läggas till.
Hur kontrollerar jag att en Webhook verkligen kommer från 7Stamp?
Beräkna HMAC-SHA256 för tidsstämpeln och den råa kroppen med Webhooks hemliga nyckel och jämför den med X-Webhook-Signature-huvudet.
Var hittar jag Webhooks hemliga nyckel?
På Webhooks sida, där den också kan återskapas.
Kan jag skydda min slutpunkt med ett lösenord?
Ja. En grundläggande autentiseringsinloggning och lösenord kan läggas till Webhook, ovanpå signaturen.
Misslyckade leveranser
En leverans som inte får något 2xx-svar inom trettio sekunder provas igen upp till tio gånger, var och en väntar fyra sekunder längre än den förra, så omförsöken avslutas inom cirka fyra minuter. Ett 429-svar med Retry-After försöker igen efter den tiden. Det första felet i en händelse lägger ett meddelande i admin.
Efter hundra misslyckade leveranser i rad blockeras Webhook av systemet och får inga fler händelser. Dess sida varnar innan dess och har en Unblock-knapp; en lyckad leverans återställer räkningen.
Varje Webhooks sida har en journal över sina leveranser, med förfrågan skickad och mottaget svar. Omsänd skickar samma händelse igen, endast till denna Webhook.
Min server låg nere. Är händelserna förlorade?
Varje leverans provas om upp till tio gånger inom cirka fyra minuter. Efter det öppnar du Webhooks journal och använder Skicka igen för de händelser du behöver.
Varför slutade min Webhook att ta emot händelser?
Efter hundra misslyckade leveranser i rad blockeras den av systemet. Fixa slutpunkten och tryck på Unblock på Webhooks sida.
Kan jag se vad som skickades till min Webhook?
Ja. Varje Webhooks sida har en journal över leveranser med förfrågan skickad och mottaget svar.
Fliken Integrationer

Fliken Integrationer listar de färdiga sätten per grupp:
- Stamp i kassan — Poster, Toast, Din egen POS eller CRM och ser du inte din POS?;
- Skattekvitton — SmartKasa;
- Automation — Make, Zapier och Public Swagger.
Varje kort säger om det behöver en API-nyckel. Fliken erbjuder samma kort i alla länder; endast skattekvitton är begränsade av land.

Ett White Label-företag ser inget Make, Zapier eller Public Swagger-kort och erbjuds inte Poster eller installationsguiderna på 7stamp.com.
Vilka POS-system är redo att ansluta?
Poster och Toast när den är påslagen för plattformen — tills dess visar den Kommer snart. Andra system ansluter via API, med din egen POS eller CRM.
Är integrationer begränsade av land?
Nej. Fliken erbjuder samma kort i alla länder. Endast skattekvitton är begränsade av land.
Varför ser jag inte Make och Zapier?
De visas inte för ett White Label-företag. Dess API-nycklar och Webhooks fungerar på samma sätt.
Poster
Poster är vår app på Poster-marknaden. Installera i Poster öppnar sin lista och appen konfigureras med API-nyckeln för en personalinloggning. Dess stämplar räknas som personalinloggningens Card Operations.
Hur ansluter jag Poster?
Öppna Integrations → Poster och välj Installera i Poster. Appen konfigureras med API-nyckeln för en personalinloggning.
Vems Card Operations använder Poster-stämplar?
De av personalinloggningen vars API-nyckel appen använder.
Behöver jag en API-nyckel för Poster?
Ja, API-nyckeln för en personalinloggning.
Toast
Toast-program Kommer snart för alla företag tills Toast-åtkomst har konfigurerats på plattformen. Det är en switch för hela plattformen, inte en inställning av verksamheten; när det väl är på, håller Toast-kortet själva installationen.
Varje Toast-plats är ansluten med sin GUID till en personalinloggning, utan någon API-nyckel: att personalinloggningens företag, stämpelkort och plan gäller för varje Toast-förfrågan från platsen. En plats kan endast kopplas till en personalinloggning, och en personalinloggning har en plats. Förfrågningar från en plats avvisas när den kopplas bort, eller medan dess personalinloggning är avstängd eller raderad.
Varje kupong kan ges en Toast menyprodukt: på Toast POS blir det då en rabatt på den produkten. En kupong utan en tillämpas som en noll rabatt på checken, och kassörskan lämnar över gåvan för hand. Kuponger löses in på Toast POS, och ett hjul som nås av en betald check snurras på en gång. När Toast ångrar en transaktion, tas dess stämplar tillbaka eller dess inlösta kuponger återställs.
En gäst kan gå med i en Toast kiosk eller gästskärm med ett telefonnummer eller en e-post. Stämpelkortet utfärdas på en gång; gästen får ingenting från 7Stamp förrän de öppnar den med samma telefon eller e-post.
Varför säger Toast Kommer snart?
Toast-åtkomst är en omkopplare för hela plattformen, inte en inställning för ditt företag. Tills den är påslagen finns det inget att ansluta.
Hur är en Toast-plats ansluten?
Genom sin GUID till en personalinloggning, utan API-nyckel. Personalinloggningens stämpelkort och plan gäller för varje begäran från platsen.
Vad händer med stämplar när Toast ogiltigförklarar en check?
När Toast ångrar en transaktion, tas dess stämplar tillbaka eller dess inlösta kuponger återställs.
SmartKasa

SmartKasa behöver ingen API-nyckel. Det är en kvittokälla i kvittoskanning, tillagd av ett SmartKasa butiks-ID eller av företagskoden för att täcka varje plats. köpare skannar SmartKasa-kvittot i företagets chatbot, och stämplarna går till personalinloggningen för den kvittokällan.
SmartKasa är ukrainskt och skattekvitton fungerar bara i Ukraina, Slovakien, Kazakstan och Uzbekistan.
Behöver jag en API-nyckel för SmartKasa?
Nej. SmartKasa är en kvittokälla i kvittoskanning, tillagd av ett butiks-ID eller av företagskoden.
Var skannar köparna ett SmartKasa-kvitto?
I ditt företags chatbot. Stämplarna går till personalinloggningen för den kvittotkällan.
I vilka länder fungerar skattekvitton?
I Ukraina, Slovakien, Kazakstan och Uzbekistan.
Make och Zapier

7Stamp-appen för Make finns i Makes offentliga appbibliotek: sök efter 7Stamp i valfritt Make-scenario eller använd Open in Make på fliken Integrationer. Vår Zapier-app finns inte i Zapiers offentliga katalog: Open in Zapier är en inbjudan som lägger till appen till företagets eget Zapier-konto. Båda apparna fungerar med API-nyckeln för en personalinloggning.
Make-scenarier och Zaps startas av 7Stamp Webhooks, så utlösare behöver Webhooks & Events-tillägget. Åtgärder som att lägga till stämplar eller utfärda en kupong behöver bara en API-nyckel. Make och Zapier erbjuds inte till ett White Label-företag.
Var hittar jag 7Stamp-appen i Make och Zapier?
I Make söker du efter 7Stamp i valfritt scenario — appen finns i Makes offentliga appbibliotek. I Zapier är den inte offentlig ännu, så använd Open in Zapier på fliken Integrationer — inbjudan lägger till appen på ditt eget konto.
Behöver Make och Zapier tillägget Webhooks & Events?
Triggers gör det, eftersom scenarier och Zaps startas av 7Stamp Webhooks. Åtgärder som att lägga till stämplar eller utfärda en kupong behöver bara en API-nyckel.
Behöver jag en API-nyckel för Make eller Zapier?
Ja. Apparna fungerar med API-nyckeln för en personalinloggning.