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

Типы поддерживаемых операций:

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

Оплата чеков возврата через платежную систему О!плати не доступна.

Конфигурирование модуля

Для использования модуля необходимо установить пакет artix-oplati.

aptitude install artix-oplati

Запрос к платежной системе О!плати выполняется при выборе специального типа оплаты. Для добавления типа оплаты необходимо выполнить конфигурирование модуля. Номер типа оплаты задается в процессе конфигурирования.

Конфигурирование модуля
dpkg-reconfigure artix-oplati

Настройки платежной системы задаются в конфигурационном файле /linuxcash/cash/paysystems/oplati/oplati.conf в секции [Main].

Режим работы платежной системы О!плати задается параметром mode:

  • при значении 0 включен режим "Сканирование QR-кода покупателя",
  • при значении 1 включен режим "Сканирование QR-кода мерчанта – Статический QR",
  • при значении 2 включен режим "Сканирование QR-кода мерчанта – Динамический QR".
НаименованиеТип данныхВозможные значенияОписаниеПримечания
urlстроковый
Адрес сервераПо умолчанию http://localhost
timeoutцелочисленный
Время ожидания ответа от сервера (в секундах)По умолчанию 10 секунд

regNum

строковый

Регистрационный номер кассы


mode

целочисленный
  • 0
  • 1
  • 2
Режим работы платежной системы О!плати:
Пример настройки
[Main]
; Настройки процессинга О!плати

; Адрес сервера
; По умолчанию http://localhost
;url = http://localhost

; Время ожидания ответа от сервера (в секундах)
; По умолчанию 10 секунд
;timeout = 10

; Регистрационный номер кассы
;regNum =

; Режим работы платежной системы О!плати
; 0 - Сканирование QR-кода покупателя (Consumer Presented Mode) 
; 1 - Сканирование QR-кода мерчанта - Статический QR (Merchant Presented Mode - Static QR)
; 2 - Сканирование QR-кода мерчанта - Динамический QR (Merchant Presented Mode - Dynamic QR)
; По умолчанию 0
;mode = 0

При первом обращении к платежной системе О!плати в директории /linuxcash/cash/paysystems/oplati/ создается файл token.conf, который содержит токен для работы с платежной системой.

Оплата чека продажи и добавление карты лояльности через платежную систему О!плати невозможны, если произошла рассинхронизация токена. В этом случае на экран будет выведена ошибка "Токен уже существует или касса работает в режиме пароля". Для исправления ситуации необходимо сбросить токен в личном кабинете платежной системы О!плати и продолжить работу.

Если токен был сброшен в личном кабинете платежной системы О!плати, но рассинхронизации не было, то при обращении к платежной системе О!плати на экран будет выведена ошибка "Необходимо получить новый токен в кассовом ПО либо касса не зарегистрирована в личном кабинете юр. лица". Для исправления ситуации требуется удалить файл token.conf, перезапустить программу и продолжить работу.

Если при оплате чека продажи/возврата по чеку продажи возникла ошибка соединения с сервером, то на экран будет выведена ошибка “Ошибка обращения к серверу”. При повторной попытке совершить оплату, если связь не восстановлена, на экран будет выведена ошибка "Возможность проведения операций с использованием платежной системы "О!плати" временно недоступна".

Если во время отмены платежа в чеке продажи/возврата по чеку продажи отсутствует связь с сервером, то на экран будет выведено предупреждение "Ошибка соединения с сервером. Операция отмены в очереди будет выполнена после восстановления связи с сервером". При попытке совершить оплату, если связь с сервером не восстановлена, будет выведена ошибка "Возможность проведения операций с использованием платежной системы "О!плати" временно недоступна". Проведение операций с использованием платежной системы О!плати будет доступно после восстановления связи с сервером и успешной отправки операции отмены из очереди.

Для печати отчетов по безналу используется шаблон oplati.xml, который после установки пакета artix-oplati добавляется в директорию /linuxcash/cash/reports.

Оплата чека продажи

В режиме "Сканирование QR-кода покупателя"

Для проведения оплаты кассиру необходимо отсканировать QR-код с телефона покупателя.

В режиме "Сканирование QR-кода мерчанта – Статический QR"

Для проведения оплаты:

  1. Покупатель сканирует QR-код мерчанта.
  2. Кассир выбирает тип оплаты "О!плати", на экран выводится диалог с кодом подтверждения, его необходимо сообщить покупателю.
  3. Покупатель вводит код подтверждения в приложении.

В режиме "Сканирование QR-кода мерчанта – Динамический QR"

Для проведения оплаты:

  1. Кассир выбирает тип оплаты "О!плати", на экран выводится QR-код с сообщением "Отсканируйте QR-код для оплаты".
  2. Покупатель сканирует QR-код и подтверждает оплату в приложении.

Добавление карты лояльности в чек

Чтобы добавить карту лояльности в чек продажи необходимо:

  1. В утилите администрирования Yuki на клавишу настроить действие с командой COMMAND_CARD, указать параметры:
    • valutcode = код валюты О!плати (номер типа оплаты),
    • cardNumberType = 5 (добавление карты через процессинг).
  2. Включить способ ввода "Получение данных от процессинга" для группы карт (БД Dictionaries таблица Cardgroup поле inputmask = 32).

Добавление карты лояльности в чек осуществляется согласно режиму, который задан с помощью параметра mode в конфигурационном файле /linuxcash/cash/paysystems/oplati/oplati.conf в секции [Main] (см. выше).

Логирование

Журнал запросов к платежной системе О!плати ведется в основном логе программы /linuxcash/logs/current/terminal.log.

  • No labels