Начиная с версии 4.6 | 5.311 реализовано прерывание операции оплаты с кассы.  

Модуль artix-pbf предназначен для выполнения оплаты платежными картами с использованием терминала.

Поддерживаемое оборудование:

  • Терминал unitodi p8 bio

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

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

Для корректной работы операции прерывания оплаты необходима прошивка терминала версии 1.96.0 и выше. Если прерывание оплаты не выполняется, то необходимо обратиться в службу поддержки PBF Group.

Установка сервиса

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

aptitude install artix-pbf

После установки пакета будет автоматически запущен сервис pbf_proxy_linux.

После обновления сервиса pbf_proxy_linux необходимо проверить актуальность настроек в файле ProxyConfig.ini и убедиться в корректном запуске сервиса. При использовании старого конфигурационного файла сервис может не запуститься.

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

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

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

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

НаименованиеТип данныхОписаниеПримечания
urlстроковыйАдрес сервиса PbfProxyПо умолчанию http://127.0.0.1:10500
timeoutцелочисленныйВремя ожидания ответа от сервиса PbfProxy в секундахПо умолчанию 120
currencyстроковыйКод валюты в ISO 4217По умолчанию 643
receiptFormatстроковыйФормат чекаПо умолчанию utf8
receiptWidthцелочисленныйШирина чекаПо умолчанию 32 символа
blPortцелочисленныйПорт бизнес-логики сервиса PbfProxy для выполнения операцийПо умолчанию 12500
Пример настройки
[Pbf]
; Адрес сервиса PbfProxy
; По умолчанию http://127.0.0.1:10500
;url = http://127.0.0.1:10500

; Время ожидания ответа от сервиса PbfProxy в секундах
; По умолчанию 120 секунд
;timeout = 120

; Код валюты в ISO 4217
; По умолчанию 643 (российский рубль)
;currency = 643

; Формат чека
; По умолчанию utf8
;receiptFormat = utf8

; Ширина чека
; По умолчанию 32 символа
;receiptWidth = 32

; Порт бизнес-логики сервиса PbfProxy для выполнения операций
; По умолчанию 12500
;blPort = 12500

Настройки сервиса PbfProxy задаются в файле /linuxcash/cash/paysystems/pbf/proxy/ProxyConfig.ini. Необходимо задать значение параметра SerialPortName.

Значение, указанное в параметре ServerPort, должно совпадать со значением порта, указанным в параметре url файла /linuxcash/cash/paysystems/pbf/pbf.ini.

Файл ProxyConfig.ini создается при первом запуске сервиса.

Пример настройки
#<optional>
[Proxy]
#<optional, single>
#<default value: "no">
AutoDetect = no
#<optional, single>
#<default value: "ttyACM0">
SerialPortName = ttyACM0
#<optional, single>
#<default value: "3000">
ConfirmationTimeout = 3000
#<optional, single>
#<default value: "10500">
ServerPort = 10500
#<optional, single>
#<default value: "10115">
FileTransferServerPort = 10115
#<optional, single>
#<default value: "">
LogsDir = 
#<optional, single>
#<default value: "2">
LogLevel = 2
#<optional, single>
#<default value: "no">
HexDump = no
#<optional, single>
#<default value: "8192">
BufferSize = 8192
#<optional, single>
#<default value: "12500">
blServerPort = 12500
#<optional, single>
#<default value: "127.0.0.1">
blServerIp2Connect = 127.0.0.1
#<optional, single>
#<default value: "12500">
blServerPort2Connect = 12346
#<optional, single>
#<default value: "0.0.0.0">
UdpVpnIp = 0.0.0.0
#<optional, single>
#<default value: "12556">
UdpVpnPort = 12556
#<optional, single>
#<default value: "5">
UdpVpnTimeout = 5

После внесения изменений в настройки необходимо перезапустить сервис pbf_proxy_linux.

Печать слипов

Печать слипа осуществляется:

  • средствами ФР – при успешной оплате/возврате,
  • через терминал:
    • сверка итогов,
    • слип с отказом при возникновении ошибок во время оплаты/возврата.

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

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

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

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

Логирование

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

  • No labels