Модуль Ланит предназначен для выполнения оплаты платежными картами с использованием банковских терминалов и ПИН клавиатур. Оборудование предоставляется банками, которые используют данный процессинг.
Для корректной работы необходимо включить отображение диалогов на экране пинпада.
Модуль представляет собой библиотеку и набор конфигурационных файлов, необходимых для обращения к процессинговому центру. При проведении оплаты платежной картой кассовая программа использует функции библиотеки. После завершения вызова кассовая программа анализирует результат выполнения и при необходимости печатает на чековой ленте содержимое квитанции.
Типы поддерживаемых операций:
- оплата,
- возврат,
- отмена оплаты или возврата,
- сверка итогов,
- печать копии слипа,
- печать краткого и полного отчета по безналу,
- проверка связи с пинпадом.
Конфигурирование модуля
Для использования процессинга необходимо установить пакет artix-plugin-lanit
, прописав команду:
aptitude install artix-plugin-lanit
Вызов клиентского приложения выполняется при выборе специального типа оплаты. Для добавления типа оплаты необходимо выполнить конфигурирование модуля. Номер типа оплаты задается в процессе конфигурирования.
dpkg-reconfigure artix-plugin-lanit
Окно выбора кода валюты, в котором нужно указать необходимый код:
При конфигурировании модуля автоматически создается и настраивается необходимым образом новый тип оплаты. Данные о типе оплаты записываются в БД.
Настройка
Файлы, необходимые для функционирования модуля, находятся в директории /linuxcash/cash/paysystems/lanit/
. Модуль состоит из двух частей: библиотеки, которая предоставляется банком, и клиентского приложения (собственная разработка).
Конфигурационные параметры клиентского приложения хранятся в файле /linuxcash/cash/paysystems/lanit/artixlanit.conf
в секциях [main] и [server]
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
cashcode | строковый | Номер кассы | По умолчанию 1 | |
currency | строковый |
| Код валюты | По умолчанию 643 (российский рубль) |
setRRNInBack | логический |
| Флаг заполнения РРН при возврате | По умолчанию true |
host | строковый | Адрес сервиса | По умолчанию | |
port | целочисленное | Порт сервиса artix-lanit | По умолчанию | |
timeout | целочисленное | Таймаут ожидания ответа от сервиса artix-lanit | По умолчанию |
[main] ; Номер кассы ; По умолчанию 1 ;cashcode = 1 ; Код валюты ; По умолчанию 643 (российский рубль) ;currency = 643 ; Флаг заполнения РРН при возврате ; true - заполнять значение РРН, false - оставить РРН пустым ; По умолчанию true ;setRRNInBack = true [server] ; Адрес сервера процессинга lanit ; По умолчанию 127.0.0.1 ;host = 127.0.0.1 ; Порт сервера процессинга lanit ; По умолчанию 58081 ;port = 58081 ; Таймаут ожидания ответа от сервера(в секундах) ; По умолчанию 300 ;timeout = 300
Конфигурационный файл /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
После перезагрузки ссылка на com-порт удаляется.
После выполнения всех настроек необходимо перезапустить программу.
Схема работы
После установки пакета artix-plugin-lanit
в системе автоматически запускается сервис artix-lanit,
который представляет собой 32-х битный tcp-сервер для работы с процессингом и является посредником между банковской библиотекой и клиентским приложением.
Управление сервисом: запуск, остановка, перезапуск осуществляется командами:
service artix-lanit start service artix-lanit stop service artix-lanit restart
Проверить текущее состояние сервиса можно при помощи команды:
service artix-lanit status
При выполнении операции через процессинг Ланит будет отправлен запрос к сервису artix-lanit
, который после обработки запроса отправит пинпаду соответствующую команду. После выполнения команды пинпад возвращает результат сервису artix-lanit
, который, в свою очередь, доставляет сообщение на кассу. При превышении времени ожидания ответа от сервиса, указанного в настройке timeout
, операция будет прервана.
Пример оплаты через процессинг Ланит:
Команды для работы с пинпадом
Для работы с пинпадом в утилите администрирования Yuki могут быть настроены пункты меню:
- печать краткого отчета по безналу с командой
COMMAND_EMV_PRINTSHORTREPORT
; - печать копии слипа с командой
COMMAND_EMV_PRINTSLIPCOPY
. При печати копии слипа будет выполнена печать последнего чека; - проверка связи с пинпадом с командой
COMMAND_EMV_TESTCONNECTION
.
Параметр valutcode
(код валюты) является обязательным для всех команд. Если параметр не указан, то при вызове команды на экран выводится предупреждение "Отсутствует обязательный параметр valutcode".
При работе с терминалом TR-POS номер операции сохраняется в файле /linuxcash/cash/paysystems/lanit/data/receipt
, учитываются все операции. После перезапуска кассы данные файла не меняются.
Логирование
Журнал вызовов клиентского приложения из кассовой программы ведется в /linuxcash/cash/paysystems/lanit/trpos.log
. В журнал заносятся параметры вызова, результат выполнения и образ слипа, который предназначен для печати.
Уровень логирования настраивается в конфигурационном файле /linuxcash/cash/paysystems/lanit/setup.txt
параметром DebugLevel.
Наименование | Тип данных | Возможные значения | Описание |
---|---|---|---|
DebugLevel | целочисленный | 0 – логирование отключено 1 – FATAL – ошибки, приводящие к остановке TRPOSX 2 – ERROR – прочие ошибки 3 – WARN – предупреждения 4 – INFO – события, входные/выходные данные 5 – DEBUG – дампы обмена сообщениями 6 – TRACE – прочая отладочная информация | Уровень логирования |
Библиотекой создается /linuxcash/cash/paysystems/lanit/trhems.log
, уровень логирования которого задается в конфигурационном файле /linuxcash/cash/paysystems/lanit/trhems.ini
параметром DebugLevel
.
Для кассового ПО Artix на базе Ubuntu 14.04 журнал работы сервиса artix-lanit
ведется в /var/log/upstart/artix-lanit.log,
для кассового ПО Artix на базе Ubuntu 18.04 - в /var/log/syslog.