Модуль Ланит предназначен для выполнения оплаты платежными картами с использованием банковских терминалов и ПИН клавиатур. Оборудование предоставляется банками, которые используют данный процессинг.

Модуль представляет собой библиотеку и набор конфигурационных файлов, необходимых для обращения к процессинговому центру. При проведении оплаты платежной картой кассовая программа использует функции библиотеки. После завершения вызова кассовая программа анализирует результат выполнения и при необходимости печатает на чековой ленте содержимое квитанции.

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

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

Конфигурирование модуля

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

aptitude install artix-plugin-lanit

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

dpkg-reconfigure artix-plugin-lanit

Окно выбора кода валюты, в котором нужно указать необходимый код:

При конфигурировании модуля автоматически создается и настраивается необходимым образом новый тип оплаты. Данные о типе оплаты записываются в БД.

Настройка

Файлы, необходимые для функционирования модуля, находятся в директории /linuxcash/cash/paysystems/lanit/. Модуль состоит из двух частей: библиотеки, которая предоставляется банком, и клиентского приложения (собственная разработка). Конфигурационные параметры клиентского приложения хранятся в файле /linuxcash/cash/paysystems/lanit/artixlanit.conf секция [main].

[main]
; Номер кассы
; По умолчанию 1
;cashcode = 1

; Код валюты
; По умолчанию 643 (российский рубль)
;currency = 643

; Флаг заполнения РРН при возврате
; true - заполнять значение РРН, false - оставить РРН пустым
; По умолчанию true
;setRRNInBack = true

Конфигурационный файл /linuxcash/cash/paysystems/lanit/trhems.ini отвечает за подключение к пинпаду через последовательный интерфейс. Параметр com = 5 назначает порт, com = n соответствует /dev/ttyS(n - 1).

server = 127.0.0.1; 20500; 0 
DefHost = 127.0.0.1; 20500; 30 
com = 5; 115200; 8n1; 41200; 200 
DebugLevel = 0;

При подключении переходника USB - COM в системе создаются порты с именами, отличными от стандартных /dev/ttyS, и для того, чтобы была возможность прописать порт в файлах конфигурации, необходимо создать символическую ссылку с именем стандартного порта. Для создания ссылки нужно проверить порт подключения через USB:

ls /dev/ttyUSB*

После выполнения команды на экран должны быть выведены все доступные USB-порты, например:

Проверить существующие com-порты:

ls /dev/ttyS*

После выполнения команды на экран должны быть выведены все доступные com-порты, например:

Команда для создания ссылки: ln -s [имя файла или каталога] [имя ссылки]. Для создания ссылки указывается порт, который еще не используется.

ln -s /dev/ttyUSB0 /dev/ttyS4

После выполнения всех настроек необходимо перезапустить программу.

Команды для работы с пинпадом

Для работы с пинпадом в утилите администрирования Yuki могут быть настроены пункты меню:

• печать краткого отчета по безналу с командой COMMAND_EMV_PRINTSHORTREPORT;
• печать копии слипа с командой COMMAND_EMV_PRINTSLIPCOPY. При печати копии слипа будет выполнена печать последнего чека;
• проверка связи с пинпадом с командой COMMAND_EMV_TESTCONNECTION.

Логирование

Журнал вызовов клиентского приложения из кассовой программы ведется в /linuxcash/cash/paysystems/lanit/trpos.log. В журнал заносятся параметры вызова, результат выполнения и образ слипа, который предназначен для печати.

Уровень логирования настраивается в конфигурационном файле /linuxcash/cash/paysystems/lanit/setup.txt параметром DebugLevel.

Библиотекой создается /linuxcash/cash/paysystems/lanit/trhems.log, уровень логирования которого задается в конфигурационном файле /linuxcash/cash/paysystems/lanit/trhems.ini параметром DebugLevel.