Panel | |
---|---|
|
Panel |
---|
Начиная с версии 4.6.171 в |
Модуль Ланит предназначен для выполнения оплаты платежными картами с использованием банковских терминалов и ПИН клавиатур. Оборудование предоставляется банками, которые используют данный процессинг.
Info |
---|
Модуль Ланит работает только на версии кассового ПО на базе Ubuntu 14.04 при включенном отображении Для корректной работы необходимо включить отображение диалогов на экране пинпадапин-пада. |
Модуль представляет собой библиотеку и набор конфигурационных файлов, необходимых для обращения к процессинговому центру. При проведении оплаты платежной картой кассовая программа использует функции библиотеки. После завершения вызова кассовая программа анализирует результат выполнения и при необходимости печатает на чековой ленте содержимое квитанции.
...
- оплата,
- возврат,
- отмена оплаты или возврата,
- сверка итогов,
- печать копии слипа,
- печать краткого и полного отчета по безналу,
- проверка связи с пин-падом.
Конфигурирование модуля
Для использования процессинга необходимо установить пакет artix-plugin-lanit
, прописав команду:.
Code Block | ||
---|---|---|
| ||
aptitude install artix-plugin-lanit |
Вызов клиентского приложения выполняется при выборе специального типа оплаты. Для добавления типа оплаты необходимо выполнить конфигурирование модуля. Номер типа оплаты задается в процессе конфигурирования.
Code Block | ||||
---|---|---|---|---|
| ||||
dpkg-reconfigure artix-plugin-lanit |
...
Файлы, необходимые для функционирования модуля, находятся в директории /linuxcash/cash/paysystems/lanit/
. Модуль состоит из двух частей: библиотеки, которая предоставляется банком, и клиентского приложения (собственная разработка).
Конфигурационные параметры клиентского приложения хранятся в файле /linuxcash/cash/paysystems/lanit/artixlanit.conf
секция в секциях [main]
и [server]
.
Секция | Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|---|
main | cashcode | строковый | Номер кассы | По умолчанию 1 | |
currency | строковый |
| Код валюты | По умолчанию 643 (российский рубль) | |
setRRNInBack | логический |
| Флаг заполнения РРН при возврате | По умолчанию true | |
regexPattern | строковый | Правило разбора введенного номера карты | По умолчанию (.{6})(.{6})(.*) | ||
regexRule | строковый | Правило преобразования введенного номера карты | По умолчанию \1******\3 | ||
server | host | строковый | Адрес сервиса | По умолчанию | |
port | целочисленное | Порт сервиса artix-lanit | По умолчанию | ||
timeout | целочисленное | Таймаут ожидания ответа от сервиса artix-lanit | По умолчанию |
Code Block | ||||
---|---|---|---|---|
| ||||
[main]
; Номер кассы
; По умолчанию 1
;cashcode = 1
; Код валюты
; По умолчанию 643 (российский рубль)
;currency = 643
; Флаг заполнения РРН при возврате
; true - заполнять значение РРН, false - оставить РРН пустым
; По умолчанию true
;setRRNInBack = true
; Правило разбора введенного номера карты
; По умолчанию (.{6})(.{6})(.*)
;regexPattern = (.{6})(.{6})(.*)
; Правило преобразования введенного номера карты
; По умолчанию \1******\3
;regexRule = \1******\3
[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
назначает 42
назначает порт, com = n
соответствует /dev/ttyS(n - 1)
.
Code Block | ||||
---|---|---|---|---|
| ||||
server = 127.0.0.1; 20500; 0 DefHost = 127.0.0.1; 20500; 30 com = 542; 115200; 8n1; 41200; 200 DebugLevel = 0; |
При подключении переходника USB - COM в системе создаются порты с именами, отличными от стандартных /dev/ttyS,
и для того, чтобы была возможность прописать порт в файлах конфигурации, необходимо создать символическую ссылку с именем стандартного порта. Для создания ссылки нужно проверить порт подключения через USB:
Code Block |
---|
ls /dev/ttyUSB* |
После выполнения команды на экран должны быть выведены все доступные USB-порты, например:
Проверить существующие com-порты:
...
Правило для автоматического подключения пин-пада указано в /etc/udev/rules.d/40_artix_lanit.rules
:
Code Block |
---|
SUBSYSTEMS=="usb", ACTION=="add" ATTRS{idVendor}=="079b", ATTRS{idProduct}=="0028", RUN+="/bin/bash /linuxcash/cash/paysystems/lanit/lanit_start.sh $env{DEVNAME}" |
Согласно этому правилу при подключении пин-пада в директории /dev/
автоматически создается символьная ссылка, которая соответствует параметру com
в конфигурационном файле /linuxcash/cash/paysystems/lanit/trhems.ini
.
Для проверки факта создания символьной ссылки можно воспользоваться командой:
Code Block | ||
---|---|---|
| ||
ls /dev/ttyStty* |
После выполнения команды на экран должны быть выведены все доступные com-порты, например:
Команда для создания ссылки: ln -s [имя файла или каталога] [имя ссылки]
. Для создания ссылки указывается порт, который еще не используется.
Code Block | ||
---|---|---|
| ||
ln -s /dev/ttyUSB0 /dev/ttyS4 |
Info |
---|
После перезагрузки ссылка на com-порт удаляется. |
После выполнения всех настроек необходимо перезапустить программу.
Команды для работы с пинпадом
...
Схема работы
После установки пакета artix-plugin-lanit
в системе автоматически запускается сервис artix-lanit
, который представляет собой 32-х битный tcp-сервер для работы с процессингом и является посредником между банковской библиотекой trposx-gcc4.1
и клиентским приложением.
Info |
---|
Выпуск новых версий 32-х битной библиотеки |
Управление сервисом: запуск, остановка, перезапуск осуществляется командами:
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
, операция будет прервана.
Пример оплаты через процессинг Ланит:
Команды для работы с пин-падом
Для работы с пин-падом в утилите администрирования Yuki могут быть настроены пункты меню:
- печать краткого отчета по безналу с командой
COMMAND_EMV_PRINTSHORTREPORT
;, - печать копии слипа с командой
COMMAND_EMV_PRINTSLIPCOPY
. При печати копии слипа будет выполнена печать последнего чека;, - проверка связи с пинпадом пин-падом с командой
COMMAND_EMV_TESTCONNECTION
.
...
Библиотекой создается /linuxcash/cash/paysystems/lanit/trhems.log
, уровень логирования которого задается в конфигурационном файле /linuxcash/cash/paysystems/lanit/trhems.ini
параметром DebugLevel
.
Журнал работы сервиса artix-lanit
ведется в /var/log/syslog
.