Модуль PayMe предназначен для выполнения оплаты платежными картами с использованием клиентского приложения PaymeGO, которое генерирует QR-код для оплаты. QR-код рассчитан только на 1 платёж, повторно совершить платеж по QR-коду невозможно. Время действия QR-кода — 30 секунд.
Функционал поддержан для кассового ПО Artix на базе Ubuntu 14.04 и 18.04.
Типы поддерживаемых операций:
- оплата,
- отмена оплаты для чека продажи,
- полный возврат по чеку продажи.
Возврат по чеку продажи, содержащему акцизные товары (алкогольную или табачную продукцию, обувные товары или лекарственные препараты), не осуществляется.
Частичный возврат по чеку продажи запрещен.
Для оплаты чека продажи необходимо отсканировать QR-код.
Кассовая программа анализирует результат выполнения запроса к процессинговой системе PaymeGo и при необходимости печатает на чековой ленте содержимое печатного образа.
Банковская квитанция получается от процессинговой системы и печатается 2 раза.
Конфигурирование модуля
Для использования модуля необходимо установить пакет artix-payme.
aptitude install artix-payme
Запрос к процессинговой системе PaymeGo выполняется при выборе специального типа оплаты. Для добавления типа оплаты необходимо выполнить конфигурирование модуля. Номер типа оплаты задается в процессе конфигурирования.
dpkg-reconfigure artix-payme
Настройки процессинга задаются в файле /linuxcash/cash/conf/paymego.conf
в секции [Main]
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
timeout | целочисленный | Время ожидания ответа от сервера (в секундах) | По умолчанию 10 секунд |
url | строковый | Адрес сервера | По умолчанию http://localhost |
posId | строковый | Код кассы | По умолчанию id |
posKey | целочисленный | Ключ кассы | По умолчанию key |
printWidth | целочисленный | Ширина печати слипов (в символах) | По умолчанию 36 символов |
payDuration | целочисленный | Продолжительность опроса состояния выполнения оплаты (в миллисекундах) | По умолчанию 300000 |
frequency | целочисленный | Частота опроса состояния оплаты (в миллисекундах) | По умолчанию 10000 |
[Main] ; Настройки процессинга PaymeGo ; Время ожидания ответа от сервера (в секундах) ; По умолчанию 10 секунд ;timeout = 10 ; Адрес сервера ; По умолчанию http://localhost ;url = "" ; Код кассы ; По умолчанию id ;posId = "" ; Ключ кассы ; По умолчанию key ;posKey = "" ; Ширина печати слипов (в символах) ; По умолчанию 36 ;printWidth = 36 ; Продолжительность опроса состояния выполнения оплаты (в миллисекундах) ; По умолчанию 300000 ;payDuration = 300000 ; Частота опроса состояния оплаты (в миллисекундах) ; По умолчанию 10000 ;frequency = 10000
Если во время оплаты чека от сервера приходит ответ со статусом, не равным 4 (успешная оплата), то запрос на оплату чека будет отправляться на сервер в течение времени, указанного в параметре payDuration
, с частотой, указанной в параметре frequency
.
Если по истечении времени, указанного в параметре payDuration
, оплата не прошла, то на экран будет выведен диалог "Результат оплаты неизвестен: таймаут ожидания ответа от сервера. Повторить?":
- при нажатии клавиши "Ввод" на сервер будет отправлен повторный запрос на оплату чека;
при нажатии клавиши "Отмена" диалог закрывается и на экран выводится ошибка "Результат оплаты неизвестен: таймаут ожидания ответа от сервера".
Логирование
Журнал запросов к процессинговой системе PaymeGo ведется в основном логе /linuxcash/logs/current/terminal.log
.