Обзор сценариев карты лояльности
Сценарии жизненного цикла карты лояльности в Кошельке
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.
Этот сценарий подходит для промо-акций с уникальными кодами (например, нанесёнными на упаковку товара). Пользователю необходимо ввести такой код на экране с описанием акции в Кошельке, затем Кошелёк отправит код и данные пользователя в информационную систему партнёра.
В сценарии предусмотрена защита от фрод-атак: для этого Кошелёк помимо кода передаёт партнёру уникальный идентификатор пользователя или устройства, которые партнёр может использовать для защиты от фрода при обработке кодов.
Партнёр может заблокировать участие пользователя в промо-акции временно или постоянно, если пользователь заподозрен в фроде. В этом случае Кошелёк сообщит пользователю о блокировке участия в акции.
4. Сценарии работы с любимыми категориями
4.1. Получение пользователем списка категорий для выбора или уже установленных через приложение партнера
Примечание
Сценарий доступен начиная с версии API 1.4.0.
Сценарий предназначен для отображения пользователю: - списка категорий для выбора при наступлении очередного периода для этого - уже выбранных категорий для текущего периода
С учетом передачи информации о карте и пользователе при получении списка категорий есть возможность его персонализировать для конкретного пользователя.
4.2. Установка пользователем любимых категорий
Примечание
Сценарий доступен начиная с версии API 1.4.0.
Сценарий предназначен для установки пользователем любимых категорий. При этом будет осуществляться синхронизация с уже установленными категориями и продуктами, если они были выбраны через другие каналы партнера.
Дополнительные сценарии Loyalty Online API
По согласованию с партнёром, в рамках Loyalty Online API возможна поддержка дополнительных методов, обусловленных особыми требованиями партнёра.