Developer integration

7stamp Webhooks

Доступно

Надсилайте кожну loyalty-подію з 7stamp у власні системи в реальному часі. Без polling і без scheduled API calls. Події прилітають як HTTPS POST буквально за секунди після того, як сталися.

Використовуйте webhooks, щоб синхронізувати CRM, ERP або власний backend із тим, що відбувається в loyalty-шарі: хто приєднався, хто отримав штамп, хто погасив ваучер, у кого спрацював birthday gift або inactivity trigger. Далі саме ваші системи вирішують, що робити з цими даними.

Що можна робити з webhooks

Webhooks - це outbound-частина integration stack. Вони дзеркалять customer і reward activity у системи, яким ви вже довіряєте для продажів, сервісу, аналітики та комунікації.

Дзеркалити loyalty history у CRM

Кожен штамп, ваучер, birthday trigger і inactivity trigger потрапляє в CRM-картку клієнта. Повна loyalty-стрічка видно поруч із продажами, дзвінками та заявками без потреби заходити в 7stamp.

Запускати власний messaging stack

Коли клієнт погасив ваучер, відправте thank-you SMS через ваш поточний SMS gateway. Коли клієнт закрив ціль, надішліть celebration-повідомлення в Slack. Коли людина стала inactive, передайте кейс account manager-у.

Живити аналітику та звірки

Стрімте події у BI, data warehouse або reconciliation pipeline. Зіставляйте voucher redemptions із POS-чеками та рахуйте loyalty ROI у своїх метриках.

Доступні події

`card_issued` — видано нову wallet-картку.
`card_saved` — клієнт зберіг картку у wallet.
`card_opened` — клієнт відкрив картку у wallet.
`stamp_added` — до картки додано штамп.
`goal_reached` — клієнт закрив stamp-goal.
`reward_issued` — видано винагороду типу award, voucher або lottery result.
`voucher_issued` — видано ваучер.
`voucher_redeemed` — ваучер погашено.
`voucher_expired` — ваучер дійшов до терміну завершення.
`lottery_played` — клієнт зіграв у лотерею та отримав результат.
`birthday_reached` — день народження клієнта тригернув campaign.
`inactivity_trigger` — клієнт дійшов до win-back inactivity threshold.
`campaign_sent` — campaign відправлено сегменту.

Приклад 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"
  }
}

Як налаштувати

01

Відкрийте admin.7stamp.com і перейдіть у Stamp Cards -> API & Integrations -> Webhooks.

02

Додайте URL свого endpoint. Лише HTTPS.

03

Оберіть типи подій, які хочете отримувати.

04

Збережіть. Події почнуть приходити за секунди.

Безпека

Кожен webhook payload підписується через HMAC-SHA256. Перед обробкою перевіряйте заголовок X-7stamp-Signature. Endpoint має відповідати HTTP 200 не довше ніж за 10 секунд. Невдалі доставки ретраяться з exponential backoff до 24 годин.

Часті запитання

У чому різниця між webhooks і REST API?

Webhooks виштовхують події з 7stamp назовні в реальному часі. REST API дає вашому ПЗ можливість випускати картки, додавати штампи й створювати ваучери через виклики в 7stamp.

Чи можна обрати, які саме події отримувати?

Так. Під час налаштування endpoint ви самі обираєте типи подій, на які хочете підписатися.

Чи потрібні Zapier або Make, щоб користуватися webhooks?

Ні. Webhooks працюють напряму з вашим backend. Zapier і Make - це лише no-code wrappers над тим самим event stream, коли вони вийдуть.

Наступний крок

Потрібні loyalty events у CRM в реальному часі?

Використовуйте webhooks, якщо у вашої команди вже є backend або integration layer і потрібен повний контроль над тим, що відбувається після кожної loyalty-події.