Публичное пространство
SetRetail SCO v.3◾Оплата покупки через СБП в мобильном приложении
https://crystals.atlassian.net/browse/SCOD-1491
https://crystals.atlassian.net/browse/SCOD-1494
https://crystals.atlassian.net/browse/CR-12968
10.4.12.0
Описание
Начиная с версии 10.4.12.0 добавлена функциональность оплаты чека с помощью СБП в мобильном приложении торговой сети в случае, если покупатель применил электронную карту лояльности в чеке.
Ценность
Доработка позволяет улучшить опыт участия в программе лояльности, а также делает процесс оплаты чека более гибким за счет предоставления дополнительных удобных вариантов оплаты.
Пример работы успешного сценария
1. Покупатель добавляет товары в чек → покупатель нажимает Перейти к оплате.
2. Покупатель сканирует штрихкод карты лояльности из мобильного приложения.
3. На экране выбора типов оплат покупатель нажимает Оплата по QR-коду/NFC СБП.
4. КСО обращается в процессинг банка, заданного на КСО, и инициирует оплату СБП.
5. КСО передает данные для оплаты в внешний процессинг лояльности.
6. Внешний процессинг лояльности отправляет данные для оплаты в мобильное приложение покупателя.
7. На экране КСО отображается модальное окно с предложением перейти в мобильное приложение магазина для оплаты.
*В случае, если покупатель закрыл окно нажатием на крестик, тогда оплата через мобильное приложение отменена → КСО возвращается на экран выбора типов оплаты.
8. Покупатель подтверждает оплату в мобильном приложении → КСО регистрирует чек.
Пример работы отрицательного сценария
Ошибки при отправке информации в процессинг лояльности (404, 422)
1. Покупатель добавляет товары в чек → покупатель нажимает Перейти к оплате.
2. Покупатель сканирует штрихкод карты лояльности из мобильного приложения.
3. На экране выбора типов оплат покупатель нажимает Оплата по QR-коду/NFC СБП.
4. КСО обращается в процессинг банка, заданного на КСО, и инициирует оплату СБП.
5. КСО передает данные для оплаты в внешний процессинг лояльности → КСО получает ошибку передачи данных от процессинга.
6. На экране КСО отображается модальное окно с QR-кодом для оплаты и текстом Отсканируйте QR-код из приложения банка или через камеру телефона.
*В случае, если покупатель закрыл окно нажатием на крестик, тогда оплата по QR-коду отменена → КСО возвращается на экран выбора типов оплаты.
7. Покупатель сканирует QR-код и подтверждает оплату → КСО регистрирует чек.
Покупателю не пришло уведомление в мобильном приложении
1. Покупатель добавляет товары в чек → покупатель нажимает Перейти к оплате.
2. Покупатель сканирует штрихкод карты лояльности из мобильного приложения.
3. На экране выбора типов оплат покупатель нажимает Оплата по QR-коду/NFC СБП.
4. КСО обращается в процессинг банка, заданного на КСО, и инициирует оплату СБП.
5. КСО передает данные для оплаты в внешний процессинг лояльности.
6. Внешний процессинг лояльности отправляет данные для оплаты в мобильное приложение покупателя.
7. Уведомление для подтверждения платежа не получено → покупатель уведомляет консультанта об отсутствии уведомления для подтверждения платежа
8. Консультант прерывает оплату через мобильное приложение и нажимает на крестик в правом верхнем угла баннера.
9. КСО отправляет запрос на отмену QR-кода → касса возвращается на экран выбора типов оплат.
10. Покупатель выбирает другой способ оплаты и закрывает чек.
Ограничения
1. На данный момент поддерживается только работа динамических платежных ссылок на КСО SetRetail SCO v.3. Поддержка технологии статических ссылок будет реализована в следующих версиях.
2. Для корректной работы функциональности статичная ссылка не должна быть настроена, так как в случае, если ссылка просто имеется в настроечных файлах или в базе данных, тогда она активируется по умолчанию.
3. После применения электронной карты лояльности оплату по СБП можно произвести только через мобильное приложение.
4. При сканировании физической карты лояльности оплата через мобильное приложение не предлагается.
Настройка
Настройка на сервере
Для корректной работы функциональности на кассе должен быть настроен способ оплаты Оплата по QR-коду/NFC СБП, а также внешний процессинг оплаты по QR-коду и внешний процессинг лояльности торговой сети.
1. Войдите на сервер SetCentrum/SetRetail10 → перейдите в раздел Кассовый модуль → вкладка Шаблоны касс → выберите шаблон кассы самообслуживания SCO_3 → нажмите на шаблон дважды для редактирования.
2. Перейдите в раздел ПРОЦЕСС ТОРГОВЛИ → вкладка НАСТРОЙКИ → меню Типы оплат → включите тип оплаты 
3. Настройте оплату по QR-коду/через СБП для требуемого банковского процессинга. Инструкции для поддерживаемых процессингов в разделе https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/1841791649.
4. В разделе Интеграция → Внешние процессинги → 
Настройка изображения
После применения электронной карты лояльности покупателя и выбора способа оплаты по СБП на экране отобразится баннер-подсказка с указанием перейти в мобильное приложение для оплаты чека. По дефолту отображается баннер ниже:
Требования к изображению
размер файла:
1080х500px - размер изображения в 9:16;
1280х808px - размер изображения в 4:3.
поддерживаемый формат изображений: png, jpeg, svg;
название файла: qr_external_payment_banner.
Локальная загрузка изображения
Чтобы загрузить кастомизированное изображение подключитесь к кассе → перейдите в папку /home/tc/storage/crystal-cash/images/client → загрузите требуемую картинку в папку.
Загрузка изображения через SetSync
Подробная инструкция по загрузке изображений для кастомизации интерфейса с помощью SetSync описана в статье https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/4463952055 в главе Настройки.