https://crystals.atlassian.net/browse/SLS-4086

https://crystals.atlassian.net/browse/CR-10682

Set Retail 10.4.14.0

SET LOYALTY 2025.3.0

Описание

Авторизация с помощью динамического кода – это безопасный способ авторизации покупателя на кассе, не требующий дополнительной процедуры подтверждения списания бонусов (или выдачи другого типа вознаграждения). Срок жизни кода ограничен, что предотвращает его перехват и подбор.

Начиная с версии 10.4.27.0 возможность подтверждения списания бонусов с помощью динамического кода доступна также при других способах авторизации – при добавлении карты лояльности по номеру телефона, отсканированному штрихкоду карты и др.

Общие правила

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

• Мобильное приложение или Telegram-бот ритейлера получает динамический код через API SetLoyalty и преобразует его в штрихкод PDF417 или QR-код – в тот формат, который может быть считан используемым кассовым оборудованием.

Open

• Срок действия динамического кода по умолчанию составляет 30 минут. Параметр настраиваемый.

• Карта может быть добавлена в чек, даже если динамический код устарел (данная возможность зависит от установленных настроек). Однако при таком способе авторизации не обеспечивается безопасность операции списания бонусов (или предоставления другого типа вознаграждения), поэтому при включенной настройке валидации потребуется:

  • повторное сканирование штрихкода/QR-кода, предварительно обновлённого покупателем в приложении;

  • подтверждение через одноразовый пароль (OTP).

Ценность

Преимущества использования динамического кода для авторизации покупателя и защиты операции списания бонусов:

• Снижение затрат на SMS и звонки при подтверждении списания бонусов.

• Ускорение обслуживания покупателей за счет отсутствия необходимости отправки и ввода на кассе кода подтверждения.

• Сокращение количества применений карты лояльности к чужим покупкам, и как следствие:

  • достоверность данных в истории покупок участников программы лояльности;

  • построение актуальных сегментов покупателей;

  • отправка релевантных персонализированных предложений.

Настройка

Перейдите в раздел CDP: Покупатели → Настройки → откройте вкладку ВАЛИДАЦИЯ.

Open

На вкладке ОПЕРАЦИИ откройте вкладку Подтверждение выдачи вознаграждения → установите требуемые настройки валидации → нажмите .

Open

Перейдите на вкладку ПАРАМЕТРЫ → укажите период обновления динамического кода в минутах → укажите количество попыток цифрового ввода кода подтверждения и время ожидания ввода кода в секундах → нажмите на иконку для редактирования текста сообщения → введите заголовок (необходим при использовании мобильных пуш-уведомлений в качестве канала отправки кода подтверждения) → введите текст сообщения {{secret_code}} для генерации кода подтверждения → нажмите → нажмите .

Open

Примеры

Сценарий 1. Авторизация по динамическому коду с проверкой его актуальности

Исходные условия

В разделе CDP: Покупатели → Настройки → на вкладке ВАЛИДАЦИЯ установлена настройка:

• Проверять актуальность динамического кода при авторизации покупателя на кассе

Кейс 1. Код актуален

1. Покупатель на своем мобильном устройстве открывает приложение и предъявляет кассиру ШК в формате PDF-417 или QR-код.

2. Кассир сканирует штрихкод/QR-код.

3. Касса проверяет динамический код на актуальность.

4. Код валиден.

5. Касса добавляет карту в чек.

6. Покупатель запрашивает списание бонусов.

7. Бонусы успешно списываются без дополнительной процедуры подтверждения.

Кейс 2. Код устарел

1. Покупатель на своем мобильном устройстве открывает приложение и предъявляет кассиру ШК в формате PDF-417 или QR-код.

2. Кассир сканирует штрихкод/QR-код.

3. Касса проверяет динамический код на актуальность.

4. Код устарел (невалиден).

5. Касса не добавляет карту в чек и выводит на экран сообщение: Код устарел. Обновите код в мобильном приложении для повторного добавления и предлагает варианты действий:

   1. Отменить – карта не будет добавлена в чек.

   2. Добавить по телефону – откроется окно добавления карты по номеру телефона (кассе SetTouch данная кнопка появляется при условии включенной настройки Добавление карты по номеру телефона в разделе Кассовый модуль → Шаблоны касс → [Шаблон кассы] → на вкладке ФУНКЦИИ).

Клавиатурная касса

Open

 

Set Touch

Open

6. Кассир передаёт информацию покупателю и закрывает сообщение.

7. Покупатель обновляет код в мобильном приложении и предъявляет кассиру.

8. Кассир сканирует штрихкод/QR-код.

9. Касса проверяет код на актуальность.

10. Код валиден.

11. Касса добавляет карту в чек.

12. Покупатель запрашивает списание бонусов.

13. Бонусы успешно списываются без дополнительной процедуры подтверждения.

Сценарий 2. Авторизация без проверки кода при включенной валидации выдачи вознаграждения

Исходные условия

В разделе CDP: Покупатели → Настройки → на вкладке ВАЛИДАЦИЯ установлены настройки:

• Проверять актуальность динамического кода при авторизации покупателя на кассе

• Валидировать выдачу вознаграждения кодом/динамическим кодом, если покупатель авторизовался

  • по номеру телефона

  • по динамическому коду

  • по отсканированной полосе карты

  • по отсканированному штрихкоду карты

  • по номеру карты, введенному вручную

Кейс 1: Код актуален

1. Покупатель на своем мобильном устройстве открывает приложение и предъявляет кассиру ШК в формате PDF-417 или QR-код.

2. Карта добавляется в чек.

3. Касса запоминает динамический код, который считала при авторизации.

4. Покупатель запрашивает списание бонусов.

5. Касса проверяет код на актуальность действия.

6. Код валиден.

7. Касса списывает бонусы.

Кейс 2: Код устарел

1. Покупатель на своем мобильном устройстве открывает приложение и предъявляет кассиру ШК в формате PDF-417 или QR-код.

2. Кассир сканирует штрихкод/QR-код.

3. Карта добавляется в чек.

4. Касса запоминает динамический код, который считала при авторизации.

5. Покупатель запрашивает списание бонусов.

6. Касса проверяет динамический код на актуальность действия.

7. Код не валиден.

8. Касса блокирует операцию списания и выводит сообщение: Списание невозможно! Код устарел. Обновите код в мобильном приложении или подтвердите списание кодом, полученным на телефон с вариантами действий:

   1. Повторить – касса запросит повторное сканирование штрихкода/QR-кода, который покупателю необходимо будет предварительно обновить в приложении.

   2. Подтвердить по телефону – запускается сценарий подтверждения по телефону (данный процесс должен быть настроен, иначе касса выведет ошибку Сервис валидации не доступен).

Клавиатурная касса

Open

Set Touch

Open

10. Кассир нажимает Повторить.

11. Касса предлагает отсканировать карту лояльности из приложения.

Клавиатурная касса

Open

Set Touch

Open

11. Покупатель обновляет код в приложении и предъявляет кассиру.

12. Кассир сканирует обновленный штрихкод/QR-код. Скидка по бонусам отображается в чеке.

Клавиатурная касса

Open

 

Set Touch

Open

 

13. Кассир закрывает чек. Бонусы успешно списываются.

Сценарий 3. Валидация выдачи вознаграждения динамическим кодом при другом способе авторизации

https://crystals.atlassian.net/browse/SLS-5276

Set Retail 10.4.27.0

SET LOYALTY 2026.4.0

Исходные условия

В разделе CDP: Покупатели → Настройки → на вкладке ВАЛИДАЦИЯ включены настройки:

• Валидировать выдачу вознаграждения кодом/динамическим кодом, если покупатель авторизовался

  • по номеру телефона

  • по отсканированной полосе карты

  • по отсканированному штрихкоду карты

  • по номеру карты, введенному вручную

• Предлагать подтверждение операции динамическим кодом на кассе

Значение настройки Проверять актуальность динамического кода при авторизации покупателя на кассе – любое.

Кейс 1: Код актуален

1. Кассир формирует чек и добавляет карту лояльности покупателя любым из следующих способов:

   • по номеру телефона;

   • по отсканированной полосе карты;

   • по отсканированному штрихкоду карты;

   • по номеру карты, введенному вручную.

2. Кассир переходит к расчету.

3. Покупатель запрашивает списание бонусов.

4. Кассир вызывает функцию списания бонусов → подтверждает сумму бонусов к списанию.

5. Касса выводит сообщение: Отсканируйте карту из приложения или отправьте проверочный код на телефон с вариантами действий:

   • Отправить на телефон – запустить сценарий подтверждения по телефону (данный процесс должен быть настроен, иначе касса выведет ошибку Сервис валидации не доступен).

   • Отмена – закрыть окно и вернуться к оплате.

Клавиатурная касса

Open

Set Touch

Open

6. Кассир уведомляет покупателя о возможности подтверждения операции списания с помощью мобильного приложения.

7. Кассир сканирует штрихкод/QR-код с экрана устройства покупателя.

8. Касса проверяет код.

9. Код валиден.

10. Касса применяет бонусы.

11. Покупатель оплачивает чек.

Клавиатурная касса

Open

 

Set Touch

Open

Кейс 2: Код устарел

1. Кассир формирует чек и добавляет карту лояльности покупателя одним из способов:

   • по номеру телефона;

   • по отсканированной полосе карты;

   • по отсканированному штрихкоду карты;

   • по номеру карты, введенному вручную.

2. Кассир переходит к расчету.

3. Покупатель запрашивает списание бонусов.

4. Кассир вызывает функцию списания бонусов → подтверждает сумму бонусов к списанию.

5. Касса выводит сообщение: Отсканируйте карту из приложения или отправьте проверочный код на телефон с вариантами действий:

   • Отправить на телефон – запустить сценарий подтверждения по телефону (данный процесс должен быть настроен, иначе касса выведет ошибку Сервис валидации не доступен).

   • Отмена – закрыть окно и вернуться к оплате.

Клавиатурная касса

Open

Set Touch

Open

6. Кассир уведомляет покупателя о возможности подтверждения операции списания с помощью мобильного приложения.

7. Кассир сканирует штрихкод/QR-код с экрана устройства покупателя.

8. Касса проверяет код → код неактуален → касса блокирует операцию списания и выводит сообщение: Списание невозможно! Код устарел. Обновите код в мобильном приложении или подтвердите списание кодом, полученным на телефон с вариантами действий:

   • Повторить – касса запросит повторное сканирование штрихкода/QR-кода, который покупателю необходимо будет предварительно обновить в приложении.

   • Подтвердить по телефону – запускается сценарий подтверждения по телефону (данный процесс должен быть настроен, иначе касса выведет ошибку Сервис валидации не доступен).

Клавиатурная касса

Open

 

Set Touch

Open

9. Кассир нажимает кнопку Повторить.

10. Касса предлагает отсканировать карту лояльности из приложения.

Клавиатурная касса

Open

 

Set Touch

Open

11. Покупатель предъявляет код кассиру заново (необходимо обновить код в приложении).

12. Если код актуален, сценарий переходит к следующему шагу, если неактуален – возвращается к шагу 8.

13. Касса применяет бонусы.

14. Покупатель оплачивает чек.

Клавиатурная касса

Open

 

Set Touch

Open

Ограничения

• Поддержка динамического кода как средства авторизации и автоматической валидации списания бонусов реализована с версии 10.4.14.0 на клавиатурных кассах, Set Touch и Set SCO v.3.

• Возможность выбора способа подтверждения списания доступна на клавиатурных кассах и Set Touch с версии 10.4.27.0. Не поддерживается для касс самообслуживания.

Статьи по теме

• SetLoyalty ◾️ Вкладка "Валидация"

• SetRetail10 ◾️ Запуск и настройка использования бонусной системы

• SetLoyalty ◾️ Использование бонусов в качестве средства оплаты

• SetLoyalty ◾️ API