Интеграции
Кассы, 1С, сайт и каналы связи, подключённые
Всё, что в магазине уже работает, продолжает работать. Кассы и 1С вызывают один кассовый API, сайт на 1С-Битрикс говорит с платформой через готовый модуль, сообщения уходят через провайдеров, с которыми у вас есть договор.
Кассовый API · /v2 · совместим с PremiumBonus
Один адрес для каждой кассы, 1С и сайта
LOYALTI реализует публичный REST API PremiumBonus на собственном адресе /v2: модуль интеграции 1С с PremiumBonus перенаправляется на наш сервер сменой хоста, пути методов, тела запросов и схема авторизации не меняются. Касса определяет покупателя по телефону, e-mail, номеру карты или коду из приложения, запрашивает расчёт и фиксирует чек после оплаты.
Движок делает всю денежную работу: правила первого совпадения, раскладка списания по накопленным, подарочным и акционным баллам, лимиты по позиции и чеку, промокоды, подарочные сертификаты, резерв баллов на время, пока кассир заканчивает чек, коды подтверждения списания, тексты чека и идемпотентность по номеру чека, чтобы повторный запрос никогда не удвоил продажу.
| Группа | Вызовов | Примеры |
|---|---|---|
| Покупатель | 14 | регистрация, информация, редактирование, баланс, список покупок, группы |
| Покупка | 10 | расчёт, покупка, информация, редактирование, отмена, смена статуса, покупка с резервом, списание без покупки |
| Коды подтверждения | 5 | отправка и проверка кодов регистрации, списания и произвольных |
| Подарочные сертификаты | 4 | выпуск, проверка, погашение, отмена |
| Приложение, дополнительно, служебные | 8 | токены приложения, проверка промокода, состояние сервиса |
POST /v2/purchase
Authorization: <ключ кассы>
{
"phone": "+79161234567",
"external_purchase_id": "chek-2026-10-22-0417",
"sale_point": "Магазин на Тверской",
"write_off_bonus": 100,
"items": [
{ "name": "Кофе в зёрнах 1 кг", "amount": 1250.50, "quantity": 1 },
{ "name": "Фильтры", "amount": 200.00, "quantity": 2 }
]
}
HTTP 200
{
"success": true,
"purchase_amount": 1450.5,
"payment_amount": 1350.5,
"total_write_off_bonus": 100,
"total_write_on_bonus": 135,
"balance": 535,
"print_on_check": "Начислено 135 баллов. Баланс: 535."
}

1С: расширение РМК и обмен CommerceML
Готовое расширение для рабочего места кассира и обмен справочниками
Расширение РМК 1С
Расширение конфигурации (.cfe) для типовых решений 1С с рабочим местом кассира: поиск покупателя по телефону или карте, регистрация на кассе, расчёт и списание баллов в чеке, печать строк лояльности, отмена и возврат. Работает по кассовому API через HTTP-соединение 1С без внешних компонентов. Ставится как обычное расширение, не меняет типовую конфигурацию и переживает её обновления.
- Совместимо с модулями, написанными под PremiumBonus: меняется только адрес сервера
- Ключи для 1С выпускаются и ротируются в кабинете, тип ключа «интеграция 1С»
- Журнал запросов 1С с маскированием ключей прямо в настройках
Обмен с 1С по CommerceML
Стандартный протокол обмена «1С:Предприятие — сайт»: каталог, цены и остатки приходят из 1С на адрес обмена с авторизацией по логину и паролю пользователя с ролью «1С». Заказы и покупки уходят обратно вебхуками. Логи обмена и сессии видны в кабинете.
- Режимы checkauth, init, file, import, query, success, как в типовом модуле
- Вебхуки 1С для покупок и списаний с подписью
- Совместимость POS API с протоколом «1С:Сервер лояльности 3.0»
Модуль 1С-Битрикс
Программа лояльности на сайте без доработки шаблона
Модуль для «1С-Битрикс: Управление сайтом» на API D7: регистрация и привязка покупателя, баланс и история в личном кабинете, бонусы на карточке товара, списание баллов в корзине и при оформлении, начисление по факту оплаты заказа, отмена при возврате. Настраивается из админки сайта, ключ и адрес сервера указываются один раз.
- Компоненты личного кабинета и бонусов на товаре, встраиваются в любой шаблон
- Списание с подтверждением кодом, лимит доли заказа из настроек программы
- Обработчики событий заказа: оплата, отмена, возврат
- Проверено на боевом магазине с кассами на 1С
POS API · /pos/v1
Компактный протокол для терминалов
Шестнадцать вызовов для терминала, которому нужно только зарегистрировать покупку, найти участника по телефону или карте, зарезервировать списание и подтвердить его кодом. Авторизация заголовком с ключом, привязка к точке, лимит запросов на ключ. Совместим с протоколом «1С:Сервер лояльности 3.0».
Справочник POS API- Поиск и регистрация участника с терминала
- Регистрация покупки с позициями и кассиром
- Резерв списания, подтверждение одноразовым кодом, освобождение
- Проверка реферального кода на кассе
Bitrix24
CRM в одном ритме с программой
Участники, их балансы и покупки уходят в контакты и сделки Bitrix24; вебхуки Bitrix24 возвращают новые контакты и изменения сделок. Сопоставление полей и направление синхронизации настраиваются по тенанту.
- Сопоставление контактов и сделок с пользовательскими полями баланса и уровня
- Входящий вебхук с общим секретом
- Журнал синхронизации и повтор из экрана интеграций
Каналы связи
Шесть каналов, одно сообщение, нужный канал каждому
| Канал | Провайдер | Что поддерживается |
|---|---|---|
| SMS | SMS.ru, SMSC | Имя отправителя, статусы доставки, одноразовые коды регистрации и списания, отправка кампаний по часовому поясу получателя |
| MAX | Бот MAX | Сообщения кампаний и одноразовые коды в мессенджере, привязка из портала |
| Telegram | Ваш бот | Привязка по ссылке, сообщения кампаний, одноразовые коды, баланс и история по запросу, меню на языке участника |
| Viber | Бот Viber | Сообщения кампаний с кнопками, привязка из портала, статус доставки |
| Любой SMTP | Шаблоны по событиям, редактор писем для кампаний, учёт открытий и кликов, платформенные письма для подтверждения и паролей | |
| Push | APNs и FCM | Токены устройств из приложения, push-кампании, обновление карт Wallet |
Ключи провайдеров вводятся один раз в панели суперадмина и хранятся зашифрованными. Каждый тенант выбирает имена отправителей, шаблоны и приоритет каналов для кампаний с запасными каналами. Режим песочницы доставляет только тестовым получателям, поэтому тестовый тенант никогда не пишет реальным клиентам.

Apple Wallet и Google Wallet
Карта, которую сканирует касса и обновляет телефон
Карта лояльности с именем участника, балансом и уровнем, штрихкодом или QR для кассы, вашими цветами и логотипом. Выпускается из портала или по ссылке в сообщении; баланс на карте обновляется после каждой покупки.
- Apple Wallet с вашим сертификатом, Google Wallet с сервисным аккаунтом
- Панель электронных карт: выпущено, установлено, активно, списания с карт
- Пластиковая и электронная карта делят один номер
Исходящие вебхуки
Ваши системы узнают о каждом событии
Адреса с секретом подписи подписываются на события участников, баллов, уровней и заказов. Доставки логируются с ответом и повторяются из очереди, поэтому учётная система, BI или CDP идут в ногу без опроса.
| Событие | Когда |
|---|---|
| member.created | Участник зарегистрировался из любого источника |
| member.updated | Изменились профиль, согласия или метки |
| points.earned | Чек, начисление или сценарий добавили баллы |
| points.redeemed | Баллами оплачена покупка или код |
| points.expired | Баллы сгорели по сроку |
| tier.upgraded, tier.downgraded | Участник перешёл между уровнями |
| order.approved, order.canceled | Заказ согласован или отменён |
Мобильное приложение
Брендированное приложение под iOS и Android на том же API
Портал участника закрывает браузер; когда бренду нужно собственное приложение, мы делаем его на Platform API и кассовом API: баланс и история, карта в Wallet, акции и кампании, push-уведомления, регистрация и подтверждение телефона, QR-код для кассы. Поставляется как отдельный проект рядом с платформой, под обе платформы.
- Токены приложения и регистрация устройств уже есть в кассовом API
- Push через APNs и FCM уже подключён к кампаниям
- Приложение использует тех же участников, балансы и правила, что кассы и сайт
Резервные копии
Дампы по расписанию в S3, восстановление из кабинета
Сервис резервных копий снимает дамп базы по расписанию, хранит окно копий локально и в любом S3-совместимом хранилище, в том числе российском, и логирует каждый запуск. Восстановление тенанта или всей платформы запускается из кабинета.
Мониторинг
Prometheus, Grafana, Loki и Alertmanager в комплекте
Платформа отдаёт health-эндпоинт и метрики запросов, очередей и касс. Стек мониторинга поставляется с дашбордами и правилами алертов; панель суперадмина показывает очереди, логи и алерты, не выходя из продукта.