...
Модуль "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. В журнал заносятся параметры вызова, результат выполнения и образ слипа, который предназначен для печати.