Интеграции

Кассы, 1С, сайт и каналы связи, подключённые

Всё, что в магазине уже работает, продолжает работать. Кассы и 1С вызывают один кассовый API, сайт на 1С-Битрикс говорит с платформой через готовый модуль, сообщения уходят через провайдеров, с которыми у вас есть договор.

Кассовый API · /v2 · совместим с PremiumBonus

Один адрес для каждой кассы, 1С и сайта

LOYALTI реализует публичный REST API PremiumBonus на собственном адресе /v2: модуль интеграции 1С с PremiumBonus перенаправляется на наш сервер сменой хоста, пути методов, тела запросов и схема авторизации не меняются. Касса определяет покупателя по телефону, e-mail, номеру карты или коду из приложения, запрашивает расчёт и фиксирует чек после оплаты.

Движок делает всю денежную работу: правила первого совпадения, раскладка списания по накопленным, подарочным и акционным баллам, лимиты по позиции и чеку, промокоды, подарочные сертификаты, резерв баллов на время, пока кассир заканчивает чек, коды подтверждения списания, тексты чека и идемпотентность по номеру чека, чтобы повторный запрос никогда не удвоил продажу.

ГруппаВызововПримеры
Покупатель14регистрация, информация, редактирование, баланс, список покупок, группы
Покупка10расчёт, покупка, информация, редактирование, отмена, смена статуса, покупка с резервом, списание без покупки
Коды подтверждения5отправка и проверка кодов регистрации, списания и произвольных
Подарочные сертификаты4выпуск, проверка, погашение, отмена
Приложение, дополнительно, служебные8токены приложения, проверка промокода, состояние сервиса
Все 41 вызов кассового API
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 возвращают новые контакты и изменения сделок. Сопоставление полей и направление синхронизации настраиваются по тенанту.

  • Сопоставление контактов и сделок с пользовательскими полями баланса и уровня
  • Входящий вебхук с общим секретом
  • Журнал синхронизации и повтор из экрана интеграций

Каналы связи

Шесть каналов, одно сообщение, нужный канал каждому

КаналПровайдерЧто поддерживается
SMSSMS.ru, SMSCИмя отправителя, статусы доставки, одноразовые коды регистрации и списания, отправка кампаний по часовому поясу получателя
MAXБот MAXСообщения кампаний и одноразовые коды в мессенджере, привязка из портала
TelegramВаш ботПривязка по ссылке, сообщения кампаний, одноразовые коды, баланс и история по запросу, меню на языке участника
ViberБот ViberСообщения кампаний с кнопками, привязка из портала, статус доставки
E-mailЛюбой SMTPШаблоны по событиям, редактор писем для кампаний, учёт открытий и кликов, платформенные письма для подтверждения и паролей
PushAPNs и 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-эндпоинт и метрики запросов, очередей и касс. Стек мониторинга поставляется с дашбордами и правилами алертов; панель суперадмина показывает очереди, логи и алерты, не выходя из продукта.