Глосарій Loyalty 5+1
Цей глосарій визначає кожен термін, що використовується у 10 механіках Costless Loyalty 5+1, адмін-панелі, картці клієнта та тарифній сітці. Кожне визначення написане для власника бізнесу, який вперше налаштовує програму — без передбачуваних знань індустрії. Терміни з Wikipedia / Wikidata посилаються на авторитетне джерело.
1. Механіки 12 термінів
Фішка UA · «Штамп» (RU) · Stamp (EN)#stamp
Одиниця накопичення, що видається клієнту за кваліфікаційний візит, покупку або транзакцію. Цифровий еквівалент діркового отвору на паперовій картці. У Costless 5+1 одна фішка зазвичай нараховується за одну кваліфікаційну дію; у мульти-товарних режимах нараховуються N фішок за один скан.
Wikipedia: Loyalty card · Links: /loyalty/stamp-classic, /loyalty/stamp-cart, /loyalty/stamp-spend
Тариф — S / M / L#tier
Маркована за розміром смуга нагороди (Small, Medium, Large), яку встановлює власник бізнесу. Тариф визначає цінність нагороди, яку клієнт отримує по завершенню картки. Costless підтримує від 1 до N тарифів; 3 (S/M/L) — стандартне значення.
Wikipedia: Loyalty program · Links: /loyalty/tier-visit, /loyalty/tier-item, /loyalty/tier-spend
Поріг#threshold
Кількість фішок (або сума витрат), яку клієнт повинен накопичити до моменту, коли картка стає повною і нагорода стає доступною. Нижчий поріг = частіші нагороди; вищий поріг = більший середній чек.
Правило калібрування: поріг ≥ середній чек ÷ 1.5 (мінімум) та ≤ середній чек × 10 (максимум реалістичний).
Накопичувальна сума#cumulative-spend
Загальна грошова сума, яку клієнт витратив протягом усіх кваліфікаційних візитів у межах одного циклу картки. Використовується в механіках stamp-per-amount, spend-total, spend-tier, tier-spend. Відрізняється від дискретних фішок (які лічать візити чи товари).
Кваліфікатор мінімального чека#minimum-check-qualifier
Бінарний перемикач, що блокує нарахування фішок, якщо одна транзакція не досягає заданого мінімуму. Запобігає мікро-транзакціям у грі з карткою. Приклад: «Нарахувати фішку лише якщо чек ≥ 150 грн».
Нагорода — фіксована / по тарифу / меню#reward
Вигода, яку клієнт отримує по завершенню картки. Три типи: фіксована — заздалегідь визначений товар незалежно від тарифу; по тарифу — нагорода масштабується до досягнутого тарифу; відкрите меню — бариста обирає з затвердженого списку при погашенні.
Series-бонус#series-bonus
Додаткова нагорода, що активується коли клієнт завершує задану кількість послідовних карток. Збільшує довгострокову лояльність створенням стрік-стимулів на рівні картки. Відрізняється від Streak (який — за візит).
Механіка 5+1#five-plus-one
Наша назва для формату stamp-card: збери 5 кваліфікаційних дій (візитів, товарів чи сум витрат), отримай 1 нагороду на 6-й кваліфікаційній дії. «+1» — це безкоштовна нагорода, що активується після перетину порогу. Програма підтримує 10 поширених варіантів цієї механіки з 16 валідних конфігурацій.
«5+1» без пробілів. Не «5 + 1».
Фішка-за-візит#stamp-per-visit
Варіант механіки, де одна фішка нараховується за один кваліфікаційний візит клієнта, незалежно від суми покупки чи кількості товарів. Ідеально для кав'ярень, барбершопів і сервісних бізнесів зо стабільним середнім чеком.
Фішка-за-товар#stamp-per-item
Варіант механіки, де одна фішка нараховується за одиницю кваліфікаційного товару. Приклад: 1 фішка за круасан. Нагороджує часті покупки конкретного товару.
Фішка-за-суму#stamp-per-amount
Варіант, де фішки нараховуються за визначеним інтервалом витрат. Приклад: 1 фішка за кожні 100 грн. Враховує змінні розміри чеків і мульти-товарні покупки.
Тарифна фішка#tier-stamp
Гібридна механіка, де і кількість фішок, і поріг тарифу визначають нагороду. Клієнти збирають фішки звичним способом, але рівень нагороди при завершенні залежить від того, чи їхня сукупна кваліфікаційна активність досягла межі S, M чи L.
2. Крос-варіантні нагороди 2 терміни
Нагорода на день народження#birthday-reward
Налаштування на рівні програми, доступне для кожного варіанту Costless 5+1. Якщо профіль клієнта має дату народження, плюс він відвідує заклад у налаштованому вікні навколо дати (наприклад, тиждень-два), плюс уже заробив певну кількість бонусів — платформа видає подарунковий бонус (один на рік). Для тарифних програм автоматично прив'язується до найдешевшого товару нижчого тарифу, щоб новий клієнт міг його погасити.
Не окрема механіка — крос-варіантний шар утримання.
Бонус за стрік#streak-reward
Налаштування на рівні програми, доступне для кожного варіанту. Кожен валідний скан QR просуває стрік клієнта: візит у налаштованому вікні від попереднього — стрік +1; інакше стрік скидається. Коли стрік досягає налаштованого порогу — клієнт заробляє додатковий бонус.
Відрізняється від Series-бонусу (який — за завершену картку, не за візит).
3. Технічні 12 термінів
QR-код (одноразовий, 90-секундний)#qr-code
Машино-зчитуваний 2D штрих-код, що відображається на панелі бариста й сканується камерою клієнта для нарахування фішки чи погашення бонусу. У Costless 5+1 кожен QR-код одноразовий і завершується через 90 секунд після генерації. Код містить дані для коректного нарахування — кому, скільки і яка програма.
Wikipedia: QR code
PIN (4-цифровий, прив'язаний до програми, дійсний 90 секунд)#pin
4-цифровий одноразовий пароль, що видається разом із QR-кодом при погашенні бонусу. Використовується як альтернативний шлях, коли камера бариста не працює або клієнт надає перевагу набору. PIN прив'язаний до конкретної програми — клієнт іншого бізнесу з тим самим PIN не може випадково перехопити погашення. Той же 90-секундний термін дії, що й у QR.
Wikipedia: One-time password
Redemption-токен (128-бітний UUID, 32 hex)#redemption-token
Криптографічно випадковий 32-символьний ідентифікатор, що генерується сервером для кожної спроби погашення. Живе у системі 90 секунд. Той самий токен переживає 3-хвилинне вікно ідемпотентності — якщо клієнт випадково закриває браузер і повертається, система видає той самий PIN на той самий запит, без подвійного списання.
Wikipedia: UUID
Вікно ідемпотентності (3 хвилини)#resume-window
Серверне вікно ідемпотентності: повторне натискання «Отримати бонус» протягом 3 хвилин від уже відкритого запиту повертає ТОЙ САМИЙ PIN — без дубльованих записів, без подвійного списання. Переживає випадкове закриття браузера, короткочасну втрату Wi-Fi.
Magic-link логін#magic-link-login
Одноразова URL-адреса автентифікації, надіслана на email клієнта, щоб залогінити його без пароля. Відрізняється від magic-link нарахування фішки (який несе очікувані фішки). Magic-link дійсний для одного використання.
Wikipedia: Authentication — passwordless login sub-concept
Magic-link нарахування фішки#magic-link-stamp-grant
Спеціалізований потік для перших клієнтів: коли неавторизований клієнт сканує QR і надає лише email (без пароля, без застосунку), сервер зберігає очікувані фішки у безпечній черзі разом із одноразовим посиланням. Клієнт натискає посилання у листі → відкривається сторінка нарахування → якщо залогінений, фішки нараховуються; якщо ні, спочатку логін, потім нарахування. Посилання одноразове — після кліку атомарно позначається використаним.
Відрізняється від magic-link логіну (вище).
Картка у браузері#browser-based-card
Картка лояльності, що живе у браузері клієнта — без встановлення застосунку. Клієнт має доступ через URL, додану в закладки або як shortcut на головному екрані. Costless Loyalty 5+1 повністю браузерний.
Wikipedia: Web application
URL-зберігання картки#url-based-card-storage
Архітектура, де стан картки клієнта (кількість фішок, тариф, історія) зберігається на сервері та доступний через стабільне веб-посилання, унікальне для цієї картки. Без застосунку, без локального зберігання на пристрої, без Wallet-інтеграції. Картка переживає зміну пристроїв через magic-link логін.
Card ID#card-id
UUID, призначений кожній картці клієнта при створенні. Закодований у URL картки. Глобально унікальний і ніколи не використовується повторно.
Панель бариста#barista-panel
Інтерфейс оператора, що використовується персоналом для нарахування фішок і валідації погашень. Доступний через бізнес-URL на будь-якому пристрої (телефон, планшет, ПК). Показує кнопку генерації QR, ручне введення PIN і поточний стан сеансу.
Картка клієнта#customer-card
Клієнтський інтерфейс, що показує поточну кількість фішок, прогрес тарифу, статус нагороди, бейдж стріку та історію картки. Доступ через унікальний URL картки.
Rate limit (10 спроб / хвилину / користувач)#rate-limit
Обмеження пропускної здатності для запобігання масовому підбиранню PIN і повторним атакам. При перевищенні клієнт бачить повідомлення «Спробуйте за хвилину».
Wikipedia: Rate limiting
4. Бізнес 5 термінів
Середній чек#average-check
Середнє значення однієї транзакції клієнта в даній локації. Використовується для калібрування порогів фішок: рекомендований діапазон — середній чек ÷ 1.5 (мінімум) до середній чек × 5–10 (максимум).
Wikipedia: Average transaction value
Локація / мульти-локаційність#location
Одне фізичне приміщення бізнесу, зареєстроване у кампанії Costless Loyalty 5+1. Мульти-локаційність означає одну кампанію, активну за кількома адресами. Free тариф — 1 локація; Starter — 3; Business — 10; Network — 50; Enterprise — 50+.
Кампанія#campaign
Налаштований екземпляр механіки лояльності — включає варіант механіки, поріг, налаштування нагороди, перемикачі день народження / стрік і активні локації. Бізнес може запускати кілька кампаній одночасно для різних товарів чи сегментів клієнтів. Free: 1 активна кампанія. Starter: 3. Business: 10. Network/Enterprise: ∞.
Wikipedia: Marketing campaign
Погашення#redemption
Дія отримання нагороди коли картка завершена. У Costless 5+1 погашення підтверджується баристом: клієнт запитує через модальне вікно бонусу, сервер видає 90-секундний QR + 4-цифровий PIN, бариста валідує через validate-qr або validate-pin і натискає «Підтвердити». Картка обнуляється після успішного погашення.
Правило калібрування порогу#threshold-calibration
Формула, яку Costless рекомендує для встановлення відповідного порогу фішок: Мінімум = середній чек ÷ 1.5; Максимум = середній чек × 5–10. Нижче мінімуму — клієнти перевикуповують; вище максимуму — залученість падає.
5. Тарифи 8 термінів
Тарифний план#plan-tier
Один із 5 рівнів сервісу Costless: Free, Starter, Business, Network, Enterprise. Кожен тариф закриває певний набір функцій (кількість локацій, кампаній, баристів, режими фішок, глибина аналітики, доступ до API, AI-помічник). Клієнти можуть апгрейдити/даунгрейдити будь-коли.
Wikipedia: Freemium
Free тариф#tier-free
Безкоштовний назавжди план: 1 локація, 1 активна кампанія, 2 акаунти бариста, тільки simple stamp-режим, базова аналітика, необмежені картки клієнтів, необмежені magic-link emails. Подарунки на день народження + стріки включені. Не входить: tiered режим, повна аналітика, експорт, API, AI-помічник. Безкоштовно назавжди — не 14-денна пробна версія.
Starter тариф#tier-starter
Початковий платний тариф: 3 локації, 3 кампанії, 5 баристів, усі 6 stamp-режимів (simple + tiered), повна аналітика, всі 4 bonus_model, AI-помічник. Ціна за регіоном: $29/міс R1, $19/міс R2, $12/міс R3.
Business тариф — Найпопулярніший#tier-business
Тариф для росту: 10 локацій, 10 кампаній, 20 баристів, усі функції Starter + експорт аналітики CSV/Excel. Ціна: $69/міс R1, $45/міс R2, $29/міс R3.
Network тариф#tier-network
Мульти-локаційний тариф: 50 локацій, ∞ кампаній, ∞ баристів, усі функції Business + доступ до REST API. Ціна: $189/міс R1, $125/міс R2, $79/міс R3. Жорстко обмежений 50 локаціями у V1.
Enterprise тариф#tier-enterprise
50+ локацій або кастомні вимоги. Включає все з Network + кастомні інтеграції + SLA + DPA + виділена підтримка. Ціна: за запитом.
Регіон (R1 / R2 / R3)#region
Costless встановлює ціни за регіонами, щоб відображати локальну купівельну спроможність SMB SaaS: R1 (США/Велика Британія/Західна ЄС, 20 країн), R2 (ЦСЄ/Середземномор'я, 15 країн), R3 (Україна/Казахстан/інші країни, за замовчуванням). Та сама індустріальна стандартна модель, що використовують Atlassian, Notion, JetBrains, Linear. Регіон автовизначається з IP запиту; ручне перевизначення доступне.
Цикл білінгу (місячний / річний)#billing-cycle
Період підписки. Місячний за замовчуванням; річний — опціональна знижка 16.67% (10× місячного = «Заощадь 2 місяці»). Річне скасування пропорційно повертає невикористані повні місяці. Без обов'язкового річного контракту.
6. Що Costless НЕ є — Розрізнення 5 термінів
Застосункова лояльність#app-based-loyalty
Програма лояльності, де клієнт зобов'язаний завантажити та встановити окремий мобільний застосунок для участі. Приклади: Starbucks Rewards, McDonald's app, UDS, Stamp Me. Costless Loyalty 5+1 — НЕ застосункова.
Wallet-pass лояльність#wallet-pass-loyalty
Картка лояльності, що поширюється як файл Apple Wallet (.pkpass) або Google Wallet, зберігається у вбудованому гаманці телефона. Costless Loyalty 5+1 НЕ використовує Wallet-pass. Картка живе у браузері, не в гаманці пристрою.
Чому Costless обрав не використовувати Wallet-pass — див. /loyalty/methodology.
POS-інтегрована лояльність#pos-integrated-loyalty
Програма лояльності, що потребує інтеграції з касовою системою для автоматичного запису транзакцій. Приклади: Square Loyalty (потрібен Square POS), Toast Loyalty (потрібен Toast POS), Loyverse (Loyverse POS), Poster POS Loyalty (Poster POS), iiko/iikoCard (iiko POS). Costless Loyalty 5+1 НЕ POS-інтегрована — фішки нараховуються вручну через панель бариста.
Паперова stamp-картка#paper-stamp-card
Фізичний попередник: друкована картка, проштампована вручну при кожному візиті. Без захисту від шахрайства, без аналітики, легко губиться/забувається. Costless Loyalty 5+1 — цифрова заміна.
Крос-вендорна партнерська мережа#partner-network
Майбутня функція Costless, де фішки, зароблені в одному бізнесі, можуть бути погашені у партнерському (скан у бізнесі A створює фішку на картці бізнесу B). У нашій адмін-панелі є налаштування для цієї функції, але крос-вендорна логіка нарахування, потік запрошень партнерів і правила розподілу витрат — ЩЕ НЕ РЕАЛІЗОВАНО. Розкрите тут, тому що налаштування видиме в адмін-панелі і інакше виглядало б як працююча функція. На дорожній карті.