API & Integrations

14. API & Integrations

Раздел API & Integrations содержит инструменты для программной интеграции 7stamp с вашими внешними системами: CRM, POS, ERP, аналитикой и ботами в мессенджерах.

API Keys

Главная страница раздела — список API-ключей. Колонки:

• Name — название ключа, обычно совпадает с привязанным Staff name.
• Login — Staff login, к которому привязан ключ.
• API Key — сам ключ, начинается с 7loc_sc_..., по умолчанию скрыт и копируется в один клик.
• Status — Active.
• 🔄 — регенерация ключа.
• 🗑️ — удаление ключа.

Создание API key

Нажмите + ADD API KEY — откроется всплывающее окно Generate API Key:

• Scanner — выпадающий список для выбора Staff Login, к которому будет привязан ключ. У одного Staff может быть один ключ.
• Кнопки CANCEL и GENERATE.

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

Что можно делать через API

• Issue a card клиенту по email или телефону.
• Add a stamp конкретному клиенту.
• Issue a voucher — шаблонный или кастомный, с Redeem Code.
• Redeem a voucher, если вы работаете через собственный POS.
• Read state карты, прогресса и истории.
• Subscribe to Webhooks, чтобы получать события в реальном времени.

Webhooks

Webhooks отправляют события карты во внешнюю систему. Поддерживаются такие события:

• 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-интеграции

• Poster — готовая интеграция, подключается в несколько кликов.
• Serve — готовая интеграция.
• Другие кассы — по запросу. Бесплатно, если это технически реализуемо, то есть если у вашей системы есть открытый API или Webhooks.

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

Для рассылок в WhatsApp, Telegram и Viber подключается интеграция с 7loc.com. После активации канал “messengers” появляется в Campaigns рядом с PUSH и Email.

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

7stamp API + Webhooks работают с Zapier и Make (Integromat), поэтому можно строить сценарии без кода:

• “Когда приходит voucher_redeemed — добавить тег в Mailchimp”.
• “Когда приходит goal_reached — отправить уведомление в Slack”.
• “Когда приходит birthday_reached — создать задачу в CRM”.

---