Frontol 6. СБП QR - banhanman/ab-wiki GitHub Wiki

Во Frontol 6 версии 6.17.0 появилась возможность проведения следующих операций по QR-кодам через СБП (Систему быстрых платежей).

  • оплата;

  • отмена оплаты;

  • возврат;

  • отмена возврата.

Используется сервис АТОЛ PAY.

Выдержка из истории версий:

6.17.0 от 31.03.2022 ***********************************************

Внесённые изменения:

  1. Поддержана возможность оплаты по QR-кодам через систему быстрых платежей:

а) В карточку устройства платёжных систем добавлена настройка "Способ интеграции" со значениями "Frontol Driver Unit" (значение по умолчанию) и "Интеграционная библиотека";

б) В карточке вида оплаты переименована операция "Оплата банковской картой" на "Оплата банковской картой или QR-кодом";

в) Переименована группа прав "\Оплата\Оплата по банковской карте" в "\Оплата\Оплата банковской картой или QR-кодом";

г) Платежная система со способом интеграции "Интеграционная библиотека" будет доступна только при наличии лицензии Frontol Pay.

Для настройки возможности оплаты по QR-коду через СБП необходимо:

  1. Зарегистрироваться в личном кабинете сервиса АТОЛ PAY , заполнить анкету, заключить договор с банком, настроить параметры (выдаются в банке) и получить (сгенерировать) токен.

image

  1. Приобрести и активировать лицензию Frontol PAY. Лицензия Frontol Pay входит в подписку Frontol 6 Release Pack.

Для целей тестирования можно получить trial-лицензию:

  1. Настроить интеграционную библиотеку во Frontol Администратор:

  • создать платежную систему со способом интеграции «Интеграционная библиотека»;

  • привязать платежную систему к рабочему месту, с которого будут производиться регистрации с оплатой по QR-коду;

  • создать соответствующий вид оплаты, например, «QR-кодом», привязанный к виду оплат во Frontol «Оплата банковской картой или QR-кодом» с фискальным способом оплаты «Безналичными» и к платежной системе.

Подробнее см. «Свойства. Интеграционная библиотека» в разделе «Платежные системы» документа «Руководство администратора» и Приложение 4. Интеграция Frontol с системами быстрых платежей через АТОЛ PAY. Инструкция по настройке документа «Руководство интегратора».

Оплата товара по QR-коду

Для произведения оплаты выполните следующие действия:

  1. Нажмите [ Расчет ] и в открывшемся окне выберите оплату «QR-кодом».

  2. Дождитесь показа QR-кода.

  3. Предоставьте QR-код покупателю одним из доступных способов:

  • на экране покупателя;

  • на экране продавца;

  • на чековой ленте.

  1. Предложите покупателю отсканировать QR-код через камеру своего смартфона или с помощью приложения для считывания кода и осуществить платеж.

  2. Пока платеж через СБП не прошел, имеется возможность отменить оплату данным видом оплат. При этом сам документ продажи отменен не будет — процесс его оплаты можно будет продолжить, выбрав другой способ. Если отмена оплаты не требуется, этот шаг следует пропустить и перейти к п. 6. Для отмены оплаты по QR-коду нажмите кнопку «Отмена» в окне вывода QR-кода (см. п. 2). Будет выдано окно с запросом подтверждения.

Запросите у покупателя подтверждение, что он еще не начал оплачивать чек. Если покупатель подтверждает, что не успел перейти к оплате, нажмите «ОК». Процесс оплаты по QR-коду будет прерван.

Обязательно убедитесь, что покупатель не начал оплату QR-кодом, прежде чем ее отменить! В противном случае у клиента будут списаны деньги, но документ продажи будет считаться не оплаченным, и его невозможно будет корректно закрыть.

Если покупатель этого не подтверждает, нажмите «Отмена». В этом случае, а также если при подтверждении была допущена ошибка, продолжится процесс оплаты. В случае успешного завершения оплаты необходимо будет выполнить ее сторнирование.

  1. Если платеж прошел, процесс оплаты успешно завершится. Будет напечатан слип со следующими реквизитами:

  • сумма платежа в рублях;

  • код валюты;

  • референсный номер платежа;

  • идентификатор QR;

  • дата и время платежа в формате «ГГГГ-ММ-ДД чч:мм:сс»;

  • уникальный идентификатор платежа в НСПК.

При возникновении любых ошибок на любом этапе оплаты через СБП выводится сообщение о характере ошибки, оплата в документ не добавляется. В некоторых случаях также распечатывается аварийный слип с просьбой проверить статус платежа и при необходимости отменить операцию. Если ошибка вызвана проблемами со связью, будет выведено сообщение о попытке восстановления связи с сервером.

Нажмите «Отмена», чтобы прекратить ожидание. Процесс оплаты будет прерван, распечатан аварийный слип. Если кнопка «Отмена» не была нажата, и в течение 2,5 минут связь сервером не восстановилась, ПО прерывает ожидание и выводит следующее сообщение.

В аварийном слипе указываются:

  • референсный номер платежа;

  • идентификатор QR-кода.

Возможные ошибки и способы их устранения:

  • В процессе подключения драйверов оборудования произошли ошибки: Загрузка библиотеки не выполнена. Отсутствует файл С:<путь к Frontol>\Frontol6\BIN\PayQr.dll. Интеграционная библиотека не найдена. Убедиться в наличии библиотеки PayQr.dll в папке Frontol6\BIN. Проверить правильность имени библиотеки.

  • Ошибка при инициализации устройств: Ошибка при работе с устройством: Платежная система <название ПС>: Не найдена лицензия для используемого платного модуля “Frontol Pay”. Отсутствует активная лицензия на использование СБП Атол Pay. Приобрести/ Продлить подписку/ Получить триальную версию лицензии Frontol Pay для ознакомления с функционалом.

  • Ошибка интеграционной библиотеки: Net Exception: Cannot assign requested address: <…>. Ошибка обращения к API. Убедиться, что заполнено поле URL в карточке интеграционной библиотеки. Убедиться в правильности заполнения поля.

  • Ошибка интеграционной библиотеки: HTTP error 403: Forbidden. Ошибка авторизации в СБП. Заполнить поле «Токен» в карточке «Интеграционная библиотека». Убедиться в валидности токена.

  • Ошибка интеграционной библиотеки: Host not found: api.atolpay.ru. Превышение таймаута взаимодействия с сервером Атол PAY. Отменить операцию. Увеличить значение поля «Время ожидания (сек.)» в карточке «Интеграционная библиотека.

При ошибках интеграционной библиотеки HTTP error <ХХХ>:

400 — ошибка на стороне банка; ошибка валидации;

404 — пользователь / клиент / терминал / токен / транзакция не найден(а);

422 — ошибка возврата,

обратиться с службу техподдержки сервиса АТОЛ PAY.

Возврат товара, оплаченного по QR-коду

Возврат денежных средств может быть выполнен в любое время после проведения оплаты на полную сумму платежа или частичную (в тот же банк, откуда была исходная операция). Однако сумма частичных запросов на возврат не должна превышать общую сумму заказа. Для успешного возврата необходимо, чтобы на момент исполнения запроса платеж имел статус Успешно.

Возврат осуществляется по инструкции, изложенной в Руководстве оператора для предприятий торговли или питания в разделе "Возврат товаров".

Если выполнить операцию возврата невозможно, будет выведено сообщение об ошибке.

⚠️ **GitHub.com Fallback** ⚠️