...

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

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

• оплата;,
• возврат;,
• отмена оплаты или возврата;,
• сверка итогов.

Передача параметров операции - – типа операции, суммы, валюты передаются из кассовой программы через Ethernet-интерфейс по протоколу UDP. При проведении платежных операций из интерфейса кассы возможность их выполнения с терминала блокируется.

...

Для использования процессинга необходимо установить пакет artix-yarus, прописав команду:.

aptitude install artix-yarus  

Вызов клиентского приложения выполняется при выборе специального типа оплаты. Добавление типа оплаты осуществляется при конфигурировании модуля. Конфигурирование модуля выполняется по команде:

dpkg-reconfigure artix-yarus

При конфигурировании модуля необходимо указать номер типа оплаты, который будет использован в данном процессинге. После указания типа оплаты соответствующий вид валюты автоматически добавляется и настраивается в БД. Информацию о типе оплаты можно просмотреть в утилите администрирования Yuki в разделе "Справочники" /> "Валюты".

Параметры настройки процессинга задаются в конфигурационном файле /linuxcash/cash/paysystems/yarus/artixyarus.conf.

Для печати платежных квитанций (слипов) необходимо настроить взаимодействие кассовой программы и терминала. В настройках терминала указываются настройки местоположения сетевого принтера - 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

Логирование

...

; Печатать журнал операций (По умолчанию true)
; printOperationJournal = true

; Разрешить возврат операций оплаты по QR-коду на пинпаде (По умолчанию false)
; allowBackSalesByQrOnPinPad = false

; Печатать сводный отчет по терминалу в формате JSON (По умолчанию false)
; printTerminalJsonReport = false

Оплата по QR-коду

В кассовом ПО Artix реализована возможность оплаты через процессинг по QR-коду на терминале.

Для этого необходимо в утилите администрирования Yuki указать в свойствах валюты "Оплата по QR на пинпаде". Подробнее о настройке валюты можно прочитать в разделе "Валюты". 

Возврат оплаты по QR-коду

В кассовом ПО Artix по умолчанию отключена возможность возврата и отмены оплаты через процессинг YARUS по QR-коду на терминале. 

Для возможности возврата и отмены оплаты по QR-коду необходимо задать значение параметра allowBackSalesByQrOnPinPad = true в конфигурационном файле /linuxcash/cash/paysystems/yarus/artixyarus.conf.

Печать отчета из архива

Для возможности печати ответа отчета из архива на пинпаде пин-паде Yarus необходимо в утилите администрирования Yuki на клавишу или пункт меню настроить действие "Печать отчета из архива" , командой с командой COMMAND_EMV_PRINTREPORT с параметром  и параметром valutcode с указанием кода валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий". 

Таймаут ожидания отчета с пинпада пин-пада определяется параметром timeout в конфигурационном файле /linuxcash/cash/paysystems/yarus/artixyarus.conf.

...

При вызове на экран кассира выводится сообщение "Выполняется печать отчета". Кассовая программа открывает порт для печати. Необходимо выбрать на пинпаде пин-паде нужный отчет и отправить на печать. Отчет будет напечатан на ФР.

Касса ожидает печать отчета в течение таймаута, затем сообщение закрывается.  Если Если в течение установленного таймаута печать отчета на пинпаде пин-паде не была запущена, то на экран выводится диалоговое сообщение "Не удалось напечатать отчет: Истек таймаут ожидания. Повторить?". Ошибка записывается также в terminal.log.

Печать отчета по безналу

Для возможности печати отчета по безналу на пин-паде Yarus необходимо в утилите администрирования Yuki напункт меню настроить действие "Печать отчета по безналу" с командой COMMAND_EMV_PRINTREPORTи параметром valutcode с указанием кода валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий". 

Печать краткого отчета по безналу

Для возможности печати краткого отчета по безналу на пин-паде Yarus необходимо в утилите администрирования Yuki напункт меню настроить действие "Печать краткого отчета по безналу" с командой COMMAND_EMV_PRINTSHORTREPORT и параметром valutcode с указанием кода валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий". 

Печать сводного отчета

Для возможности печати сводного отчета (документ с типом 9) в формате JSON на пин-паде Yarus необходимо задать значение параметра printTerminalJsonReport = true в конфигурационном файле /linuxcash/cash/paysystems/yarus/artixyarus.conf.

Логирование

Журнал вызовов процессинга из кассовой программы ведется в основном логе /linuxcash/logs/current/terminal.log. Для идентификации данных, которые записаны данным модулем, используется логгер с именем payment. В журнал заносятся параметры вызова, результат выполнения и образ слипа, который предназначен для печати.