Модуль Epos предназначен для выполнения оплаты платежными картами с использованием банковского терминала Epos.

Функционал поддержан для кассового ПО Artix на базе Ubuntu 18.04 и 22.04.

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

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

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

Для использования модуля необходимо установить пакет artix-epos командой:

aptitude install artix-epos

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

Конфигурирование модуля
dpkg-reconfigure artix-epos

Настройки процессинга задаются в файле /linuxcash/cash/paysystems/epos/epos.ini в секции [Main]:

НаименованиеТип данныхВозможные значенияОписаниеПримечания
currencyстроковый
ВалютаПо умолчанию "RUB"
languageстроковый
  • Ru – русский,
  • En – английский,
  • Cn – китайский
Язык сообщений, выводимых на экран пин-падаПо умолчанию "Ru"
encodingстроковый
  • UTF8,
  • CP1251
Кодировка сообщений от терминала

По умолчанию "CP1251".

Значение параметра должно соответствовать значению, указанному в настройках пин-пада

Пример настройки
[Main]
; Настройки процессинга Epos

; Валюта
; По умолчанию "RUB"
;currency = RUB

; Язык сообщений, выводимых на экран пинпада. Возможные значения:
;  "Ru" - русский
;  "En" - английский
;  "Cn" - китайский
; По умолчанию "Ru"
;language = "Ru"

; Кодировка сообщений от терминала. Возможные значения:
;  "UTF8"
;  "CP1251"
; По умолчанию "CP1251"
;encoding = "CP1251"

Настройка подключения к пин-паду производится в файле /linuxcash/cash/paysystems/epos/lib/eBrige.ini:

НаименованиеТип данныхВозможные значенияОписаниеПримечания
CONNECTIONстроковый
  • COM,
  • TCP
Тип подключенияПо умолчанию COM
COMPORTстроковый
Номер com-порта или путь к файлу устройства

Обязательный параметр в случае подключения пин-пада через com-порт.

Указывается номер com-порта, к которому подключен пин-пад.

По умолчанию 0 – будет осуществляться автоматический поиск пин-пада в системе по vid:pid.

Можно указать полный путь к файлу устройства:

Пример
COMPORT=/dev/ttyUSB3
BOUNDRATEчисловой
  • 9600
  • 19200
  • 38400
  • 57600
  • 115200
Скорость работы com-порта

По умолчанию 115200

LOGLEVELчисловой
  • 0 – выключен (только обязательные сообщения),
  • 1 – ошибки,
  • 2 – ошибки и предупреждения,
  • 3 – ошибки, предупреждения и информационные сообщения,
  • 4 – все сообщения, включая отладочные
Уровень логирования библиотеки eBridgeПо умолчанию 2
LOCALEстроковый
  • EN – английский,
  • RU – русский
Язык описания ошибокПо умолчанию RU
XMLчисловой
  • 0 – не сохраняется,
  • 1 – сохраняется
Определяет, будет ли в файл eposrs.xml сохраняться ответ (чек), полученный от пин-падаПо умолчанию 1
Пример настройки
CONNECTION = COM
COMPORT    = 0
BOUNDRATE  = 115200
LOGLEVEL   = 2
LOCALE     = RU
XML        = 1

Печать отчета по безналу

Для возможности печати отчета по безналу на пин-паде Epos необходимо в утилите администрирования Yuki на клавишу или пункт меню настроить действие "Печать отчета по безналу" с командой COMMAND_EMV_PRINTREPORT и параметром valutcode с указанием кода валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий".

Печать краткого отчета по безналу

Для возможности печати краткого отчета по безналу на пин-паде Epos необходимо в утилите администрирования Yuki на пункт меню настроить действие "Печать краткого отчета по безналу" с командой COMMAND_EMV_PRINTSHORTREPORT и параметром valutcode с указанием кода валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий".

Логирование

Журнал запросов к процессинговой системе Epos ведется в файле /linuxcash/logs/current/epos.log.

Настройки логирования осуществляются в конфигурационном файле /linuxcash/cash/paysystems/epos/Artix/epos.conf.

  • No labels