API & Integrations

14. API & Integrations

Afsnittet API & Integrations indeholder værktøjer til programmatisk integration af 7stamp med jeres eksterne systemer — CRM, POS, ERP, analytics, messenger-bots.

API Keys

Sektionens hovedside er API-nøglelisten. Kolonner:

• Name — nøgle-navn (matcher ofte det tilknyttede Staff-navn).
• Login — Staff-login nøglen er bundet til.
• API Key — selve nøglen (starter med 7loc_sc_..., skjult som standard, kopieres med ét klik).
• Status — Active.
• 🔄 — genskab nøgle.
• 🗑️ — slet nøgle.

Oprettelse af API-nøgle

Tryk + ADD API KEY — popupen Generate API Key åbner:

• Scanner — dropdown til at vælge Staff Login, nøglen bindes til (én Staff kan have én nøgle).
• Knapper CANCEL / GENERATE.

Efter GENERATE oprettes nøglen og vises på listen. Kopiér den straks — den fulde nøgle vises måske ikke igen.

Hvad I kan via API’et

• Issue a card til kunde efter e-mail/telefon.
• Add a stamp til en bestemt kunde.
• Issue a voucher (skabelon eller brugerdefineret, med Redeem Code).
• Redeem a voucher (hvis I arbejder via jeres eget POS).
• Read state for kortet, fremskridt, historik.
• Subscribe to Webhooks for at modtage begivenheder i realtid.

Webhooks

Webhooks sender kortbegivenheder til et eksternt system. Understøttede (se begivenhedsordlisten):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (med resultat).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Eksempel på Webhook payload

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "customer": {
    "id": "c_789",
    "wallet_pass_id": "wp_abc",
    "language": "en"
  },
  "card": { "id": "card_001", "goal_index": 2 },
  "voucher": {
    "id": "v_555",
    "type": "voucher",
    "redeem_code": "FREECOFFEE",
    "redeem_code_formats": ["text", "qr", "barcode"],
    "status": "redeemed",
    "redeemed_via": "staff_scanner"
  }
}

Færdige POS-integrationer

• Poster — færdig integration, forbindes med få klik.
• Serve — færdig integration.
• Andre kasser — laves efter anmodning. Gratis hvis teknisk muligt (dvs. jeres kasse har åbent API eller Webhooks).

Messenger-udsendelser via 7loc.com

Til WhatsApp-, Telegram-, Viber-broadcasts forbindes 7loc.com-integrationen. Når den er aktiv, bliver «messengers»-kanalen tilgængelig i Campaigns ved siden af PUSH og E-mail.

No-code-scenarier: Zapier og Make

7stamp API + Webhooks fungerer med Zapier og Make (Integromat), så I kan bygge scenarier uden kode:

• «Når voucher_redeemed — tilføj tag i Mailchimp».
• «Når goal_reached — send notifikation til Slack».
• «Når birthday_reached — opret opgave i CRM».

---