Модуль SoftCase предназначен для выполнения оплаты платежными картами с использованием банковских терминалов и ПИН клавиатур, которые предоставлены Райффайзен Банком.

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

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

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

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

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

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

aptitude install artix-softcase

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

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

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

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

Обмен данными кассовой программы с банковским терминалом осуществляется посредством сервиса efthcxml через шлюз EFTHCXML, которые запускаются автоматически. Для проверки статуса сервиса необходимо выполнить команду:

service efthcxml status

Файлы, которые необходимы для функционирования модуля, располагаются в директории /linuxcash/cash/paysystems/softcase. Шаблон банковских слипов размещен в файле /linuxcash/cash/reports/softcase.xml. При формировании слипа используются стандартные переменные и параметры результата выполнения запроса, которые возвращает шлюз EFTHCXML:

ПеременнаяОписание

aid

Идентификатор EMV-приложения
amountСумма в рублях

applabel

Название EMV-приложения

auth

Код авторизации

card

Номер карты

carddataenc

Зашифрованный номер карты

cardholder

Владелец карты

cardid

Идентификатор диапазона номеров карт

cardtype

Тип карты (платежная система, например, VISA)

code

Код возврата
crcКонтрольная сумма

currency

Тип валюты

expdt

Срок окончания действия карты

hash

Хэш

invoice

Выставленный счет

pem

Способ ввода карты

resp

Расшифровка кода ответа

rrn

RRN
slipnumНомер слипа

tdt

Дата и время транзакции
tdttextДата и время транзакции в формате dd.MM.yy hh:mm:ss

termid

Идентификатор терминала

trace

Номер транзакции

track3

Трек 3

trancert

Криптограмма EMV-приложения

type

Тип операции
typenameНазвание операции

Настройка сервиса efthcxml осуществляется в конфигурационном файле /linuxcash/cash/paysystems/softcase/efthcxml.cfg. Подробное описание приведено в техническом описании шлюза.

Модуль SoftCase настраивается в конфигурационном файле /linuxcash/cash/paysystems/softcase/softcase.conf.

НаименованиеТип данныхВозможные значенияОписаниеПримечания

kkm

целочисленный

Номер кассы. Используется для сопоставления ответов от пин-пада запросам от касс


currency

целочисленный
  • 978 – евро
  • 643 – российский рубль
  • 840 – доллары США

Тип валюты

Применяется только для поддержания мультивалютных транзакций.

По умолчанию не используется.

host

строковый

Хост, на котором запущен сервис efthcxml

По умолчанию localhost.

port

целочисленный

Порт, на котором сервис efthcxml ожидает запросы с кассы

По умолчанию 3232.

timeout

целочисленный

Таймаут обращения к сервису efthcxml

По умолчанию 300 секунд.

Пример настройки
[softcase]
; Номер кассы
; используется для сопоставления ответов от Пин Пада запросам от касс
kkm = 1
; Тип валюты
; По-умолчанию не используется. Применяется только для поддержания мультивалютных транзакций.
; Поддерживаемые коды валют: 978 - Евро, 643 - рубли, 840 - доллары США.
;currency = 643
; Хост на котором запущен сервис efthcxml, по умолчанию localhost
;host = localhost
; Порт на котором сервис efthcxml ожидает запросы с кассы, по умолчанию 3232
;port = 3232
; Таймаут обращения к сервису efthcxml в секундах, по умолчанию 300
;timeout = 300

Логирование

Логирование работы шлюза ведется в файле /linuxcash/logs/current/eft%s.log (символ % заменяется текущей датой в формате YYYYMMDD). Файл логов может быть изменен, название и положение файла логов, а также уровень логирования указывается в файле efthcxml.cfg.

  • No labels