Перейти к содержанию

Обзор сценариев карты лояльности

Сценарии жизненного цикла карты лояльности в Кошельке


1. Регистрация пользователя в Кошельке

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

Регистрация пользователя

Регистрация пользователя

2. Основные сценарии Loyalty Online API

2.1. Выпуск карты лояльности

Пользователь может выпустить в Кошельке существующую карту (ранее зарегистрированную в системе партнёра по номеру телефона или адресу электронной почты), либо новую карту.

Перед выпуском карты пользователь принимает условия соглашения (предоставляются партнёром), указывает разрешенные каналы коммуникации оператора программы лояльности с ним (СМС, е-mail, голосовые вызовы, иные способы коммуникации). При выпуске карты происходит передача партнёру персональных данных пользователя и каналов коммуникации, одобренных пользователем.

Выпуск существующей карты

Выпуск анонимной карты

Выпуск новой карты

2.2. Сервисные запросы по карте и обновление профиля пользователя

Loyalty Online API обеспечивает основные сервисные запросы по карте:

  • получение баланса карты;
  • получение перечня специальных акций партнёра, доступных владельцу карты;
  • получение истории покупок;
  • обновление персональных данных пользователя (в случае изменения данных профиля пользователя в Кошельке обновленные данные будут переданы партнёру);
  • выпуск карты из заранее заведённого на нашей стороне пула;
  • выпуск карты без номеров (с использованием номера телефона);
  • присваивание номера карты после передачи данных партнёру в POST запросе.

Получение баланса

Получение истории покупок

Получение списка акций

Обновление персональных данных

Обновление персональных данных

Обновление персональных данных

Обновление персональных данных

3. Сценарии промо-акций

3.1. Отправка данных кассового чека

Примечание

Сценарий доступен начиная с версии API 1.1.0.

Сценарий может использоваться партнёром в рамках промо-акций с кассовыми чеками. После того, как пользователь отсканирует QR-код кассового чека на экране акции (карты), сервер Кошелька отправит партнёру сведения о пользователе и отсканированном чеке.

Отправка данных кассового чека

3.2. Отправка кода промо-акции

Примечание

Сценарий доступен начиная с версии API 1.3.0.

Этот сценарий подходит для промо-акций с уникальными кодами (например, нанесёнными на упаковку товара). Пользователю необходимо ввести такой код на экране с описанием акции в Кошельке, затем Кошелёк отправит код и данные пользователя в информационную систему партнёра.

Отправка кода промо-акции

В сценарии предусмотрена защита от фрод-атак: для этого Кошелёк помимо кода передаёт партнёру уникальный идентификатор пользователя или устройства, которые партнёр может использовать для защиты от фрода при обработке кодов.

Партнёр может заблокировать участие пользователя в промо-акции временно или постоянно, если пользователь заподозрен в фроде. В этом случае Кошелёк сообщит пользователю о блокировке участия в акции.

Дополнительные сценарии Loyalty Online API

По согласованию с партнёром, в рамках Loyalty Online API возможна поддержка дополнительных методов, обусловленных особыми требованиями партнёра.