Что заведению нужно знать о гостевом приложении

Сводка для тех, кто объясняет Simple Pass гостям и сотрудникам.

Приложения#

Скоро

В Google Play приложения ещё нет: на simple-pass.ru/app кнопка Android отдаёт APK-файлом, гостю придётся разрешить установку из этого источника. iOS ставится из App Store обычным способом.

• iOS и Android — нативные клиенты, функциональный паритет.
• Тёмное оформление, единственное светлое исключение — экран QR (для читаемости сканером).
• Оба клиента работают с одним публичным гостевым контуром API.

Куда отправлять гостя: simple-pass.ru/app. Страница сама определяет телефон и показывает нужный способ установки — отдельные ссылки давать не нужно.

Один аккаунт — много карт#

Гость глобален (идентификатор — телефон), карта — venue-scoped. Один гость может иметь карты нескольких заведений; в приложении они переключаются чипами. Если заведения в коалиции, кошелёк у карт общий.

Каналы привлечения (что видно в аналитике)#

Именные QR сотрудников создаются и отключаются в кабинете. Отключённый или чужой код не мешает гостю получить карту — просто теряется атрибуция.

Ограничение: у гостя, который ставит приложение впервые, параметр ref не переживает установку из магазина — атрибуция сработает только у тех, у кого приложение уже стоит.

Что заведение настраивает само#

• Программа лояльности: курс начисления, лимит оплаты баллами, срок сгорания баллов.
• Лестница уровней: названия, пороги, процент начисления и лимит оплаты баллами на каждой ступени, разрешено ли понижение.
• Личные условия отдельным гостям: персональная скидка (в том числе адресная, на выбранные позиции), свой процент начисления и свой лимит списания.
• Оформление карты в приложении: фоновая картинка карты заведения (кабинет → «Дизайн карты»).
• Штампы, купоны и их шаблоны (в том числе требуется ли активация перед кассой).
• Анкета гостя: произвольные поля, ответы становятся осями сегментации и подстановками в текстах рассылок.
• Оформление карты в Apple/Google Wallet: цвета и надпись.
• Правила доставки сообщений: частотный лимит рекламных сообщений в сутки и границы тихих часов (по умолчанию — 1 в сутки, тихо с 22:00 до 10:00 по времени точки).
• Отзывы: порог «хорошей» оценки, куда вести довольных гостей, компенсация недовольным.

Что заведение НЕ настраивает#

• Тексты юридических документов и их версии — платформенные, живут на сайте.
• Сертификаты Apple Wallet / Google Wallet — платформенные, одни на всю платформу.
• Формат QR карты.
• Механику входа гостя (лестница каналов «push → звонок/SMS → Telegram»).

Типичные вопросы гостей и ответы#

«Мне не приходит код». Проверьте, что номер введён верно. Код при flash-call — последние 4 цифры входящего номера, отвечать на звонок не нужно. Если звонок и SMS не дошли — на экране ввода кода есть переход в Telegram-бота.

«Куда делись баллы?» Посмотрите вкладку «История»: операция типа «сгорание» означает, что истёк срок партии баллов. Срок задаёт заведение и считается отдельно для каждой партии от момента начисления.

«Почему мне не приходят акции?» Проверьте два места: системное разрешение на уведомления в настройках телефона и тумблер «Реклама и предложения» в профиле приложения. Плюс действует лимит частоты и тихие часы.

«Я показываю скриншот QR, не сканируется». QR обновляется каждые ~45 секунд, скриншот не работает — нужен живой экран.

«Хочу удалить свои данные». В профиле есть удаление аккаунта: карты и уведомления отключаются, сессии на всех устройствах закрываются. Полное удаление данных — по обращению на адрес, указанный в приложении. Повторный вход по тому же номеру восстанавливает аккаунт, но регистрационные бонусы заново не начисляются.

Что пока не доступно гостю#

• Реферальная программа «пригласи друга» — механика в ядре есть, экрана в приложении нет.
• Кнопки добавления карты в Apple/Google Wallet в мобильных клиентах.
• Предложения по геолокации — выключены флагом в текущих релизах.
• Отображение точной даты сгорания баллов в приложении (есть только предупреждающий push и запись «сгорание» в истории).