Интеграция поддержана для терминалов PAX A800, PAX A930.

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

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

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

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

Для корректной работы приложение PSP на пин-паде необходимо перевести в режим работы с кассой.

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

aptitude install artix-halyk

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

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

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

НаименованиеТип данныхОписаниеПримечания
urlстроковыйАдрес пин-падаПо умолчанию http://localhost:8080
timeoutцелочисленныйВремя ожидания ответа от пин-пада (в секундах)По умолчанию 200
multiplierцелочисленныйМультипликатор сумм для отправки в процессингПо умолчанию 0.01
qrTimeoutцелочисленныйВремя ожидания ответа при неудачной попытке оплаты QR (в секундах)

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

При любом значении параметра ко времени ожидания дополнительно прибавляется 1 секунда.

Например, значение qrTimeout=0, значит время ожидания ответа = 1 секунда (0+1).

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

; Адрес пинпада
; По умолчанию http://localhost:8080
;url = http://localhost:8080

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

; Мультипликатор сумм для отправки в процессинг
; По умолчанию 0.01
;multiplier = 0.01

; Время ожидания ответа при неудачной попытке оплаты QR (в секундах)
; По умолчанию 2 секунды
;qrTimeout = 2

Если в течение установленного таймаута процесс оплаты не был завершен на пин-паде, то на экран кассы будет выведена ошибка "Нет связи с пинпадом".

Пин-пад отправляет на кассу сообщение о завершении операции только после закрытия экрана выполненной транзакции.

Оплата по QR-коду

В кассовом ПО Artix реализована возможность оплаты через процессинг по QR-коду на терминале.

Оплата по QR-коду реализована для кассового ПО на базе Ubuntu 18.04 и 22.04.

Убедитесь в том, что на терминале установлена прошивка, поддерживающая возможность оплаты по QR-коду.

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

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

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

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

Шаблон слипа для печати

При оплате чека будет напечатан слип, шаблон которого находится в /linuxcash/cash/reports/halyk.xml. Подробнее о редактировании шаблонов можно прочитать в разделе "Движок отчетов".

Логирование

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

  • No labels