...
Модуль "YARUS" предназначен для выполнения оплаты платежными картами с использованием банковского платежного терминала YARUS P2100.
Info |
---|
Функционал поддержан для кассового ПО Artix на базе Ubuntu 14.04 и 18.04. |
Типы поддерживаемых операций:
- оплата;,
- возврат;,
- отмена оплаты или возврата;,
- сверка итогов.
Передача параметров операции - – типа операции, суммы, валюты передаются из кассовой программы через Ethernet-интерфейс по протоколу UDP. При проведении платежных операций из интерфейса кассы возможность их выполнения с терминала блокируется.
...
Для использования процессинга необходимо установить пакет artix-yarus
, прописав команду:.
Code Block | ||
---|---|---|
| ||
aptitude install artix-yarus |
Вызов клиентского приложения выполняется при выборе специального типа оплаты. Добавление типа оплаты осуществляется при конфигурировании модуля. Конфигурирование модуля выполняется по команде:
Code Block | ||||
---|---|---|---|---|
| ||||
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 | ||
printOperationJournal | логический |
| Печатать журнал операций | По умолчанию true |
Для печати платежных квитанций (слипов) необходимо настроить взаимодействие кассовой программы и терминала. В настройках терминала указываются настройки местоположения сетевого принтера - ip адрес кассы и порт сетевого принтера (printerPort
). При настройке процессинга указываются хост и порт подключаемого терминала. Слипы платежных квитанций передаются на кассу по TCP протоколу на порт сетевого принтера.
Для добавления бонусной/дисконтной карты в чек через терминал YARUS необходимо для параметра discountCardCommand
в конфигурационном файле /linuxcash/cash/paysystems/yarus/artixyarus.conf
задать код команды в формате hex
.
Code Block | ||||
---|---|---|---|---|
| ||||
[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 |
Логирование
...
; Печатать журнал операций (По умолчанию true)
; printOperationJournal = true |
Печать отчета из архива
Для возможности печати ответа отчета из архива на пинпаде пин-паде Yarus необходимо в утилите администрирования Yuki на клавишу или пункт меню настроить действие "Печать отчета из архива" , командой с командой COMMAND_EMV_PRINTREPORT
с параметром и параметром valutcode
с указанием кода валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
Таймаут ожидания отчета с пинпада пин-пада определяется параметром timeout
в конфигурационном файле /linuxcash/cash/paysystems/yarus/artixyarus.conf
.
...
При вызове на экран кассира выводится сообщение "Выполняется печать отчета". Кассовая программа открывает порт для печати. Необходимо выбрать на пинпаде пин-паде нужный отчет и отправить на печать. Отчет будет напечатан на ФР.
Касса ожидает печать отчета в течение таймаута, затем сообщение закрывается. Если Если в течение установленного таймаута печать отчета на пинпаде пин-паде не была запущена, то на экран выводится диалоговое сообщение "Не удалось напечатать отчет: Истек таймаут ожидания. Повторить?". Ошибка записывается также в terminal.log
.
Печать краткого отчета по безналу
Для возможности печати краткого отчета по безналу на пин-паде Yarus необходимо в утилите администрирования Yuki напункт меню настроить действие "Печать краткого отчета по безналу" с командой COMMAND_EMV_PRINTSHORTREPORT
и параметром valutcode
с указанием кода валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
Логирование
Журнал вызовов процессинга из кассовой программы ведется в основном логе /linuxcash/logs/current/terminal.log
. Для идентификации данных, которые записаны данным модулем, используется логгер с именем payment
. В журнал заносятся параметры вызова, результат выполнения и образ слипа, который предназначен для печати.