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

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

  • оплата;

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

  • возврат;

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

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

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

3.10.0 от 06.04.2022 ***********************************************

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

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

а) В карточку устройства платёжных систем добавлена настройка "Способ интеграции" со значениями "Интеграционная библиотека" и "ДТО 9";

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

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

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

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

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

image

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Процесс оплаты по QR-коду будет прерван.

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

Если покупатель этого не подтверждает, нажмите «Отмена».

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

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

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

  • код валюты;

  • дата и время платежа;

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

  • уникальный идентификатор транзакции;

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

Если оплата QR-кодом не завершилась успешно, печатается аварийный слип со следующими реквизитами:

  • уникальный идентификатор транзакции;

  • идентификатор операции.

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

  • Невозможно загрузить библиотеку C:\Program Files (x86)\ATOL\Frontol xPOS3\PayQR.dll: Не найден указанный модуль. Интеграционная библиотека не найдена. Убедиться в наличии библиотеки PayQr.dll в папке \Frontol xPOS3 (для OC Windows) или /opt/ATOL/FrontolxPOS3 (для ОС Linux). Проверить правильность имени библиотеки.

  • Не найдена лицензия для используемого платного модуля «Frontol Pay». Отсутствует активная лицензия на использование СБП Атол Pay. Приобрести (либо продлить) подписку, получить триальную версию лицензии Frontol Pay для ознакомления с функционалом.

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

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

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

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

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

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

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

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

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

Возврат осуществляется по инструкции, изложенной в Руководстве оператора в разделе «Возврат товара, оплаченного QR-кодом».

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

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