Developer integration

7stamp REST API

Доступно

7stamp REST API дає повний програмний контроль над wallet loyalty cards. Випускайте картки зі своєї системи, нараховуйте штампи з будь-якого тригера, створюйте й призначайте ваучери конкретним клієнтам і забирайте аналітику у свій код.

Використовуйте API, коли треба інтегрувати 7stamp у власну POS-систему, бухгалтерську платформу, мобільний застосунок або сайт, для яких немає готової інтеграції. Zapier і Make закривають типовий стек. REST API закриває все інше.

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

API - це write-side integration stack. Використовуйте його там, де саме ваше ПЗ має лишатися операційним source of truth, а 7stamp відповідає за wallet loyalty layer.

Випускати картки зі свого ПЗ

Генеруйте персональне wallet-card link для будь-якого клієнта у вашій системі. Доставляйте його через власний email, SMS, push або in-app flow. Клієнт відкриває лінк і зберігає картку в Apple Wallet або Google Wallet.

Нараховувати штампи з будь-якого джерела

Коли покупка закрилася у вашій кастомній POS, коли онлайн-замовлення оплачене на сайті або коли послуга завершена у booking-системі, API-виклик зараховує штампи. Картка оновлюється за секунди.

Керувати ваучерами й campaign

Видавайте одноразовий ваучер конкретному клієнту, будуйте campaign-ready reward flow і повертайте voucher status назад у системи, що відповідають за фінанси та сервіс.

Типові сценарії

Власна POS або касова система

Мережа ресторанів працює на in-house POS, для якої немає marketplace integration. 7stamp API викликається із checkout layer: кожен закритий чек запускає add-stamp logic, а кожне погашення закриває ваучер. Для касира loyalty виглядає нативною.

Кастомний сайт або online ordering

Онлайн-магазин хоче loyalty для delivery orders. 7stamp API викликається з checkout flow: після оформлення замовлення клієнт отримує wallet-card link у підтвердженні, а штампи зараховуються автоматично.

Звірки в бухгалтерії чи ERP

Команді фінансів потрібно звіряти voucher redemptions із фіскальними чеками. API повертає voucher status і redemption metadata в ERP для чистішого місячного закриття.

Документація

Детальний endpoint reference, request/response schema та code samples для cURL, Python, JavaScript і PHP доступні в developer portal. Публічне посилання на developer portal ще фінально узгоджується з product owner, тому поки що зверніться до нас за доступом.

Автентифікація

API використовує API-ключі з префіксом 7loc_sc_. Кожен ключ прив'язаний до конкретного Staff Login і однієї локації. Ключі створюються в admin.7stamp.com -> Stamp Cards -> API & Integrations -> API Keys. Їх можна ротувати та відкликати будь-коли.

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

Коли краще брати REST API, а не Zapier чи Make?

REST API потрібен, коли у вас власна система, потрібен повний контроль або loyalty-дії мають виконуватися всередині вашого backend, а не в no-code шарі.

Чи можна додавати штампи із сайту або з delivery checkout?

Так. Будь-яка система, яка вміє робити HTTPS-запити, може через API випускати картки, додавати штампи та створювати ваучери.

Як скоупляться API-ключі?

Кожен API-ключ прив'язаний до Staff Login і однієї локації, щоб доступ можна було безпечно ротувати, аудіювати й відкликати.

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

Потрібно, щоб loyalty поводилася як частина вашого ПЗ?

Використовуйте REST API, коли хочете, щоб саме ваш сайт, POS, ERP або внутрішній backend керував loyalty-діями, а 7stamp відповідав за досвід wallet-card.