...
Модуль Ланит предназначен для выполнения оплаты платежными картами с использованием банковских терминалов и ПИН клавиатур. Оборудование предоставляется банками, которые используют данный процессинг.
| Info |
|---|
Модуль Ланит работает только на версии кассового ПО на базе Ubuntu 14.04 при включенном отображении Для корректной работы необходимо включить отображение диалогов на экране пинпада. |
...
- оплата,
- возврат,
- отмена оплаты или возврата,
- сверка итогов,
- печать копии слипа,
- печать краткого и полного отчета по безналу,
- проверка связи с пинпадом.
Конфигурирование модуля
Для использования процессинга необходимо установить пакет 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 | По умолчанию |
| Code Block | ||
|---|---|---|
| ||
[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).
...
После выполнения команды на экран должны быть выведены все доступные USB-порты, например:
Проверить существующие com-порты:
...
После выполнения команды на экран должны быть выведены все доступные com-порты, например:
Команда для создания ссылки: ln -s [имя файла или каталога] [имя ссылки]. Для создания ссылки указывается порт, который еще не используется.
...
После выполнения всех настроек необходимо перезапустить программу.
Схема работы
После установки пакета artix-plugin-lanit в системе автоматически запускается сервис artix-lanit, который представляет собой 32-х битный tcp-сервер для работы с процессингом и является посредником между банковской библиотекой и клиентским приложением.
Управление сервисом: запуск, остановка, перезапуск осуществляется командами:
| Code Block |
|---|
service artix-lanit start
service artix-lanit stop
service artix-lanit restart |
Проверить текущее состояние сервиса можно при помощи команды:
| Code Block |
|---|
service artix-lanit status |
При выполнении операции через процессинг Ланит будет отправлен запрос к сервису artix-lanit, который после обработки запроса отправит пинпаду соответствующую команду. После выполнения команды пинпад возвращает результат сервису artix-lanit, который, в свою очередь, доставляет сообщение на кассу. При превышении времени ожидания ответа от сервиса, указанного в настройке timeout, операция будет прервана.
Пример оплаты через процессинг Ланит:
Команды для работы с пинпадом
...
Библиотекой создается /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.