API & Integrations

14. API & Integrations

De API & Integrations-sectie bevat tools voor programmatische integration van 7stamp met externe systemen — CRM, POS, ERP, analytics en messenger bots.

API Keys

De hoofdpagina is de API key list. Columns:

• Name — key name.
• Login — Staff login waaraan de key gekoppeld is.
• API Key — de key zelf (begint met 7loc_sc_..., standaard hidden).
• Status — Active.
• 🔄 — key regenereren.
• 🗑️ — key verwijderen.

Creating an API key

Tik + ADD API KEY — de popup Generate API Key opent:

• Scanner — dropdown voor Staff Login.
• Buttons CANCEL / GENERATE.

Na GENERATE wordt de key gemaakt. Kopieer hem meteen; de volledige key wordt mogelijk niet opnieuw getoond.

Wat je via de API kunt doen

• Een card uitgeven aan een customer via email/phone.
• Een Stamp toevoegen aan een specifieke customer.
• Een Voucher uitgeven met Redeem Code.
• Een Voucher redeemen.
• Card state, progress en history lezen.
• Op Webhooks subscriben voor realtime events.

Webhooks

Webhooks sturen card events naar een extern system. Supported:

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

Webhook payload example

{
  "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"
  }
}

Ready-made POS integrations

• Poster — ready-made integration.
• Serve — ready-made integration.
• Other tills — op verzoek, gratis als technisch haalbaar.

Messenger broadcasts via 7loc.com

Voor WhatsApp, Telegram en Viber broadcasts wordt de 7loc.com integration verbonden. Daarna verschijnt het “messengers” channel in Campaigns naast PUSH en Email.

No-code scenarios: Zapier and Make

7stamp API + Webhooks werken met Zapier en Make (Integromat):

• “When voucher_redeemed — add a tag in Mailchimp”.
• “When goal_reached — send a notification to Slack”.
• “When birthday_reached — create a task in CRM”.

---