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

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

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

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

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

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

dpkg-reconfigure artix45-plugin-inpas

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

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

Файлы, необходимые для функционирования модуля, располагаются в директории /linuxcash/cash/paysystems/inpas. Библиотеки предоставляются сотрудниками банка. Настройка подключения к терминалу производится в файле /linuxcash/cash/paysystems/inpas/inpas.cfg в секции [Terminal].

[Terminal]

# Имя устройства к которому подключен терминал
DevName="/dev/ttyS4" 
 
# Адрес терминала
#Host=127.0.0.1:27015

# Таймаут подключения
#IpTimeout=2000

# Скорость порта
BaudRate=115200;

# Идентификатор терминала
Id="40000022" 

Настройка через порт COM/USB

Для подключения к терминалу через порт COM/USB необходимо в конфигурационном файле inpas.cfg в секции [Terminal] задать следующие настройки:

[Terminal]

# Имя устройства к которому подключен терминал
DevName="/dev/ttyS4"

# Скорость порта
BaudRate=115200;

# Идентификатор терминала
Id="40000022" 

Настройка через Ethernet

Для подключения к терминалу через Ethernet необходимо в конфигурационном файле inpas.cfg в секции [Terminal] задать следующие настройки:

[Terminal]
 
# Адрес терминала
Host=127.0.0.1:27015

# Таймаут подключения
IpTimeout=2000
 
# Идентификатор терминала
Id="40000022" 

Настройка процессинга Инпас

Параметры настройки работы с банковским терминалом Инпас задаются в файле /linuxcash/cash/paysystems/inpas/artixinpas.conf.

[Client]
;кодировка слипов и сообщений, которые возвращаются библиотекой
;возможны любые значения, поддерживаемые Qt - KOI8-R, Windows-1251, UTF-8 и т д
;encoding=Windows-1251
; Код валюты. По-умолчанию 643.
; У некоторых клиентов используется 810 код (старый рубль).
valutCode = 643
 
; Интервал ожидания между выполнением 2 операций(в секундах). По умолчанию 2 секунды.
intervalBetweenOperations = 2
[ErrorCodes]
; Код ошибки превышения остатка (на счете недостаточно средств)
notEnoughtBalance = 76

Состояние счета 

В модуле Inpas реализована возможность узнавать баланс на счете. Запросить баланс можно по кнопке в контексте главного меню, при формировании документа или в режиме подитога. Для проверки баланса счета в утилите администрирования Yuki необходимо на клавишу настроить действие "Состояние счета" с командой COMMAND_BANK_CARD_BALANCE и параметром valutcode, который соответствует коду валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий". 

В результате выполнения операции будет напечатан слип с информацией о состоянии счета.

Отмена и возврат

При выполнении операций отмены или возврата кассовое ПО всегда направляет терминалу команду отмены. Если терминал находит операцию отмены в текущей смене, то в банковской системе выполняется операция отмены. В противном случае выполняется возврат.

Логирование

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

Использование одного терминала для нескольких организаций

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

Прочитать о настройке программы для оплаты несколькими юридическими лицами можно в статье "Банковские платежные системы".

Особенности использования терминала Инпас для нескольких юридических лиц:

• При возврате сторнировать операцию по безналу невозможно, на экране кассира - ошибка "Отмена оплаты не доступна".
• Сверка итогов по безналу и печать отчетов по безналу производится отдельно на каждое юридическое лицо.