Термины и определения
Оператор
владелец терминала Vendotek
Комплимент
правило о предоставлении скидки/бонуса, создаваемое оператором
Коллекция
набор комплиментов, назначаемых на Терминалы Vendotek
Ключ
банковская карта, MIFARE карта, QR код - другими словами носители лояльности
Известный ключ
банковская или MIFARE карта, добавленная в список Ключей для вашей организации
Клиент
владелец ключа
Баллы
1 балл равен 1 единице в валюте страны ( например 1 балл = 1 рубль)
Комплимент позволяет гибко настраивать и управлять программами лояльности на каждом отдельном терминале или группе терминалов.
Для организации создаются Коллекции, которые состоят из Комплиментов для известных и всех остальных ключей. Известные ключи, как правило это Mifare или банковские карты, регистрируются в системе как с привязкой к конкретному клиенту, так и без нее по уникальному номеру. Все остальные ключи - это банковские карты новых или не занесенных в систему клиентов.
Организация – юридическое лицо или ИП, зарегистрированное в системе лояльности как самостоятельный участник. Организация имеет собственный набор правил (комплиментов), коллекций, клиентскую базу и выпускает карты лояльности. Организации могут быть как независимыми, так и подчиненными друг другу по древовидной иерархической системе. Для каждой дочерней организации/подразделения используются отдельные наборы Комплиментов и Коллекций.
В соответствии с требованиями НСПК для каждой организации (мерчанта) используется уникальный ключ формирования хэша карты. То есть в рамках разных организаций, которые работают с Комплиментом, будут использоваться разные идентификаторы для одной и той же банковской карты.
На терминалах Vendotek могут использоваться следующие Ключи:
- Банковские карты (пластик и устройства с NFC) (тип PAN_HASH) - идентификация по хэшу от банковской карты. Номер банковской карты хэшируется с использованием секретного ключа для создания уникальной подписи, которая подтверждает целостность и подлинность данных при операциях, не раскрывая номер, а лишь его защищенный хэш. Метод помогает защищать PAN карты в соответствии с требованиями стандартов безопасности платежных карт.
При оплате устройствами с NFC PAN вашей карты отличается из-за технологии токенизации. Это фундаментальный механизм безопасности, который защищает ваши реальные платежные данные от мошенников.
Комплимент – платформа для работы с программами лояльности на базе системы управления терминалами Vendotek (далее TMS), доступ к которому предоставляется по запросу.
Доступ к Комплименту возможен через WEB-интерфейс с любого устройства, подключенного к интернету, включая мобильные устройства. Установка дополнительного ПО не требуется. Рекомендованные для использования браузеры: Chrome, Яндекс браузер, Safari актуальных версий.
Для создания личного кабинета новым пользователям необходимо отправить запрос в техподдержку, в котором содержится:
- название организации,
- электронная почта пользователя,
- серийные номера терминалов,
- необходимость подключения к системе Комплимент.
Если у вас уже есть учетная запись в ЛК TMS, сообщите в техподдержку, о необходимости подключения к платформе Комплимент.
Рабочая область системы лояльности Комплимент при первом запуске открывается на вкладке Коллекции.
Панели:
Правая панель (сворачивается для удобства) состоит из следующих вкладок:
набор комплиментов, назначаемых на Терминалы Vendotek
правила о предоставлении скидки создаваемое клиентом
участники программы лояльности
список банковских и MIFARE карт
список операций по терминалам, участвующим в Комплименте.
Панель работы с организациями (сворачивается для удобства)
Поиск по организациям (если в вашем ЛК их несколько)
кнопки свернуть и развернуть.
Можно скрыть/развернуть панель организаций нажав ↔️.
Коллекция – это набор комплиментов,назначаемых на терминал.
Если используется работа с иерархией ЛК, то необходимо создавать коллекции и правила в конкретном подразделении/организации в дереве.
Чтобы создать Коллекцию нажмите 📄 Создать в правом верхнем углу на вкладке Коллекции.
Заполните поле Название и выберите Комплименты для известных ключей и всех остальных ключей.
Если у вас нет Комплиментов для добавления в Коллекцию, создайте их заранее на вкладке Комплименты или добавьте через панель + не покидая страницу.
(Подробнее о создании Комплиментов далее)
Нажмите 💾 Создать для сохранения коллекции. После она появится в списке. Коллекцию можно редактировать нажав на нее или удалить нажатием соответствующей иконоки 🗑️
В одну коллекцию можно добавить несколько Комплиментов как для известных, так для неизвестных ключей, нажав ➕. Клиенту применится первый подходящий комплимент из списка.
Фильтры
Для удобства пользования можно воспользоваться поиском и фильтром для поиска коллекций
Кнопки действия
Кнопка “Создать” для создания новой коллекции
Действия: 🔗 Назначить устройствам, 🗑️ Удалить коллекцию.
Для назначения Коллекции на несколько терминалов через интерфейс Комплимента:
▪️нажмите на кнопку действия “назначить устройствам”,
▪️выберите проект из выпадающего списка,
▪️введите серийные терминалы по одному в строку (если терминала нет в проекте, отобразится уведомление “SN не найден в проекте”),
▪️нажмите Назначить.
Через Профиль терминала
Перейдите на вкладку Устройства

▪️Выберите из списка или с помощью поиска найдите необходимый терминал и нажмите на его серийный номер для перехода в профиль
▪️В рабочей области терминала в Профиле программа лояльности из выпадающего списка выберите необходимую
Нажмите ✅ Применить изменения
Обновить конфигурацию терминала через вкладку Задачи или меню терминала.

После успешного создания Коллекции, вы увидите сводную информацию: название коллекции и комплименты для известных и всех остальных ключей. Также доступна функция перехода к терминалам, к которым привязана эта коллекция. Для перехода к терминалам выберите проект из выпадающего списка.
Во вкладке комплименты отображаются все Комплименты созданные оператором. Также доступен фильтр по типу Комплимента и кнопка удалить.
🪛
4 шага по созданию Комплимента
1. На вкладке Комплименты нажмите 📄 Создать в верхнем правом углу.
2. Из выпадающего списка выберите Тип комплимента.
3. Заполните предложенные поля.
4. Нажмите Сохранить.
Нажмите на кнопку с названием Комплимента, чтобы перейти к сценарию использования и описанию детальной настройки.
Раздел представляет собой базу, в которую можно добавлять клиентов, а также привязывать к ним карты лояльности (Ключи).
При создании карточки клиента заполните поля Имя, Фамилия, почта, телефон и комментарий (поля опциональные)
При создании Ключа можно выбрать ранее созданный профиль клиента для удобства идентификации
Ключ можно добавить вручную (или добавить группу ключей, через импорт .csv файла, подробнее в разделе
Работа с .csv ). После добавления в список Ключ становится “известным”,т.е. на него действует Комплимент для известных ключей. Все остальные карты, взаимодействовавшие с терминалом, появляются в списке без привязки к Коллекции.
Для создания ключа нажмите 📄 Создать в верхнем правом углу вкладки Ключи.
1️⃣ Введите ID.
2️⃣ Выберите один из типов:
▪️Идентификатор лояльности (для MIfare карт),
▪️HASH PAN (для банковских карт)
▪️ QR
Узнать ID карты можно во вкладке Комплимент->Операции, зная время проведения операции по данной карте или через вкладку Продажи (главная страница TMS-> Устройства-> нажать на серийный номер необходимого терминала->вкладка Продажи). Нажать на надпись оплата.
При наведении курсора на знак i отобразится ID Комплимента.
В чеке “Детали продажи” отображается PAN hash карты, по которой был применен Комплимент. Если нажать на номер, вы перейдете к параметрам Коллекции.
3️⃣ Далее для создания Ключа выберите текущий статус - Активен или Не активен, при необходимости введите срок действия. Если оставить поле пустым, карта начнет действовать с текущего момента.
4️⃣ Затем можно выбрать из списка или создать в этом же окне Клиента обладателя этого Ключа лояльности.
5️⃣ А так же его можно сразу привязать к Коллекции, чтобы к нему применялись соответствующие правила.
Если если предполагается, что Ключ будет использоваться в Коллекциях с депозитом или лимитом баллов его необходимо пополнить. Чтобы пополнить баланс несколько ключей, отметьте их галочкой и нажмите Пополнить и введите необходимую сумму.
Платформа лояльности Комплимент предусматривает возможность создания особых условий для VIP карт. Алгоритм действия:
- Создайте Комплимент со скидкой 100%.
- Создайте Коллекцию, добавив его в комплимент для известных ключей
- На вкладке Ключи создайте ключ и выберите для него коллекцию, созданную в П. 2
- Сохраните Ключ. Уникальные условия для будут применяться на терминалах выбранной организации, подключенных к системе Комплимент

Во вкладке операции отображаются все транзакции по терминалам вашей организации, к которым подключена система Комплимент.

В верхней части вкладки находится поиск и фильтр по типам операций:
- charge (пополнение)
- sale (продажа)
- void (отмена)
В правой части экрана находятся таблицы с итогами по каждому Комплименту с возможностью фильтрации по каждой организации для удобства аналитики.
Для ускорения загрузки ключей есть функция загрузить их через импорт файла .csv.
Кнопка располагается в правом верхнем углу на вкладке Ключи.
Здесь вы можете скачать шаблон файла, заполнить необходимые поля и загрузить его.

В окне импорта .csv перечислены столбцы файла (с указанием обязательных), где:
| Поле |
Тип |
Описание |
| LID |
string |
уникальный номер Ключа |
| TYPE |
enum |
тип ключа: PAN_HASH — банковская карта, LID — карта лояльности |
| STATUS |
enum |
активный / не активный |
| VALID_FROM |
datetime |
дата начала действия Ключа в формате гггг-ММ-дд’ЧЧ:мм:сс. |
| VALID_TO |
datetime |
окончание действия Ключа в формате гггг-ММ-дд’ЧЧ:мм:сс. |
| CLIENT_NAME |
string |
имя клиента |
| CLIENT_SURNAME |
string |
фамилия клиента |
Пример заполнения шаблона