Модуль "YARUS" предназначен для выполнения оплаты платежными картами с использованием банковского платежного терминала YARUS P2100.
Функционал поддержан для кассового ПО Artix на базе Ubuntu 14.04 и 18.04.
Типы поддерживаемых операций:
- оплата;
- возврат;
- отмена оплаты или возврата;
- сверка итогов.
Передача параметров операции - типа операции, суммы, валюты передаются из кассовой программы через Ethernet-интерфейс по протоколу UDP. При проведении платежных операций из интерфейса кассы возможность их выполнения с терминала блокируется.
Конфигурирование модуля
Для использования процессинга необходимо установить пакет artix-yarus
, прописав команду:
aptitude install artix-yarus
Вызов клиентского приложения выполняется при выборе специального типа оплаты. Добавление типа оплаты осуществляется при конфигурировании модуля. Конфигурирование модуля выполняется по команде:
dpkg-reconfigure artix-yarus
При конфигурировании модуля необходимо указать номер типа оплаты, который будет использован в данном процессинге. После указания типа оплаты соответствующий вид валюты автоматически добавляется и настраивается в БД. Информацию о типе оплаты можно просмотреть в утилите администрирования Yuki в разделе "Справочники"/"Валюты".
Параметры настройки процессинга задаются в конфигурационном файле /linuxcash/cash/paysystems/yarus/artixyarus.conf
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
encoding | строковый | Кодировка сообщений, получаемых от терминала | По умолчанию cp1251 | |
host | строковый | Хост терминала | По умолчанию 192.168.0.1 | |
port | строковый | Порт терминала | По умолчанию 5757 | |
printerPort | строковый | Порт сетевого принтера | По умолчанию 5858 | |
valCode | числовой |
| Код валюты | По умолчанию 933 |
timeout | числовой | Таймаут ожидания отчета | По умолчанию 30 секунд | |
attemptCount | числовой | Количество попыток отправки пакета | По умолчанию 5 | |
discountCardCommand | строковый | Код команды (в hex формате) для запроса номера бонусной/дисконтной карты через терминал | По умолчанию 0xF1 |
Для печати платежных квитанций (слипов) необходимо настроить взаимодействие кассовой программы и терминала. В настройках терминала указываются настройки местоположения сетевого принтера - ip адрес кассы и порт сетевого принтера (printerPort
). При настройке процессинга указываются хост и порт подключаемого терминала. Слипы платежных квитанций передаются на кассу по TCP протоколу на порт сетевого принтера.
Для добавления бонусной/дисконтной карты в чек через терминал YARUS необходимо для параметра discountCardCommand
в конфигурационном файле /linuxcash/cash/paysystems/yarus/artixyarus.conf
задать код команды в формате hex.
[main] ; Кодировка сообщений, получаемых от терминала (По умолчанию cp1251) ; encoding = cp1251 ; Хост терминала (По умолчанию 192.168.0.1) ; host = 192.168.0.1 ; Порт терминала (По умолчанию 5757) ; port = 5757 ; Порт сетевого принтера. ; Касса по текущему порту, ; дожидается сообщений от терминала (По умолчанию 5858) ; printerPort = 5858 ; Код валюты (По умолчанию 933) ; valCode = 933 ; Таймаут ожидания отчета ; timeout = 30 ; Количество попыток отправки пакета (По умолчанию 5) ; attemptCount = 5 ; Код команды (в hex формате) для запроса номера бонусной/дисконтной карты через терминал (По умолчанию 0xF1) ; discountCardCommand = 0xF1
Логирование
Журнал вызовов процессинга из кассовой программы ведется в основном логе /linuxcash/logs/current/terminal.log
. Для идентификации данных, которые записаны данным модулем, используется логгер с именем payment
. В журнал заносятся параметры вызова, результат выполнения и образ слипа, который предназначен для печати.
Печать отчета из архива
Для возможности печати ответа из архива на пинпаде Yarus необходимо на клавишу или пункт меню настроить действие "Печать отчета из архива", командой COMMAND_EMV_PRINTREPORT
с параметром valutcode
с указанием кода валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
Таймаут ожидания отчета с пинпада определяется параметром timeout
в конфигурационном файле /linuxcash/cash/paysystems/yarus/artixyarus.conf
.
Команда печати может быть вызвана по нажатию клавиши в контексте открытого документа или через пункт из главного меню.
При вызове на экран кассира выводится сообщение "Выполняется печать отчета". Кассовая программа открывает порт для печати. Необходимо выбрать на пинпаде нужный отчет и отправить на печать. Отчет будет напечатан на ФР.
Касса ожидает печать отчета в течение таймаута, затем сообщение закрывается. Если в течение установленного таймаута печать отчета на пинпаде не была запущена, то на экран выводится диалоговое сообщение "Не удалось напечатать отчет: Истек таймаут ожидания. Повторить?". Ошибка записывается также в terminal.log
.