API & Integrations

14. API & Integrations

Розділ API & Integrations містить інструменти для програмної інтеграції 7stamp з вашими зовнішніми системами — CRM, POS, ERP, аналітикою, messenger bots.

API Keys

Головна сторінка розділу — список API key. Колонки:

• Name — назва ключа (зазвичай збігається з прив’язаним Staff name).
• Login — Staff login, до якого прив’язано ключ.
• API Key — сам ключ (починається з 7loc_sc_..., прихований за замовчуванням, копіюється одним кліком).
• Status — Active.
• 🔄 — перевипустити ключ.
• 🗑️ — видалити ключ.

Створення API key

Натисніть + ADD API KEY — відкриється popup Generate API Key:

• Scanner — dropdown для вибору Staff Login, до якого буде прив’язано ключ (один Staff може мати один ключ).
• Кнопки CANCEL / GENERATE.

Після GENERATE ключ створюється і з’являється в списку. Скопіюйте його одразу — повний ключ може більше не бути показаний.

Що можна робити через API

• Issue a card клієнту за email/phone.
• Add a stamp конкретному клієнту.
• Issue a voucher (шаблонний або custom, з Redeem Code).
• Redeem a voucher (якщо ви працюєте через власний POS).
• Read state картки, прогрес, історію.
• Subscribe to Webhooks, щоб отримувати події в реальному часі.

Webhooks

Webhooks надсилають card events у зовнішню систему. Підтримуються (див. event glossary):

• 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

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

Готові POS integrations

• Poster — готова інтеграція, підключається в кілька кліків.
• Serve — готова інтеграція.
• Інші каси — робляться на запит. Безкоштовно, якщо технічно можливо (тобто ваша каса віддає відкритий API або Webhooks).

Розсилки в месенджери через 7loc.com

Для WhatsApp, Telegram, Viber-розсилок підключається інтеграція з 7loc.com. Після активації в Campaigns з’являється канал “messengers” поруч із PUSH та Email.

No-code сценарії: Zapier і Make

7stamp API + Webhooks працюють із Zapier і Make (Integromat), дозволяючи будувати сценарії без коду:

• “Коли voucher_redeemed — додати tag у Mailchimp”.
• “Коли goal_reached — надіслати notification у Slack”.
• “Коли birthday_reached — створити task у CRM”.

---