Интеграция поддержана для терминалов 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

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

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

Работа процессинга одновременно с несколькими терминалами

Для корректной работы функционала необходимо:

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

Для настройки последовательной оплаты на нескольких терминалах Halyk необходимо:

Добавить валюту, привязанную к терминалу, для оплаты товаров из определенного отдела в БД Dictionaries таблицу Valut с параметром mode = 2.
В БД Dictionaries таблице Payforbiddance указать отделы, в которых будет запрещена оплата валютой, привязанной к терминалу.

Для каждого терминала настроить секцию с указанием кода валюты [Main.<код валюты, привязанной к терминалу>] в конфигурационном файле /linuxcash/cash/paysystems/halyk/halyk.ini.

Пример настройки секций терминалов для валют с кодами 21 и 22

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

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

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

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

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

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

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

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

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

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

Добавить логическую валюту в БД Dictionaries таблицу Valut с параметром mode=2048. Правила округления и тип оплаты задаются произвольно. Выбор логической валюты при оплате будет инициировать последовательную оплату валютами, привязанными к терминалам.
Настроить соотнесение кода логической валюты и кодов валют, привязанных к терминалам, в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/processing.ini в секции [Processing.ValutMapping].
Пример маппинга
```
[Processing.ValutMapping]
; Маппинг валют для последовательной оплаты на нескольких терминалах
;
; По умолчанию секция пустая, последовательная оплата по маппингу не используется.
; <Код логической валюты> = [Список кодов валют, привязанных к терминалам]
; Список задается через запятую, например:
;8 = 7, 5
8 = 21, 22
```
Если при оплате используется валюта, привязанная к терминалу, и она не указана в маппинге, то настройки будут считываться из секции [Main].

Пример оплаты товаров из разных отделов несколькими терминалами

В чеке присутствуют товары из отделов 1 и 2.

Настроены:

Валюта с кодом 21:
- указан параметр valut.mode = 2,
- запрещена оплата валютой во всех отделах, кроме отдела 1,
- терминал 1 используется только для оплаты товаров из отдела 1 валютой с кодом 21:
  Пример настройки
```
[Main.21]
; Настройки процессинга Halyk
....
```
Валюта с кодом 22:
- указан параметр valut.mode = 2,
- запрещена оплата валютой во всех отделах, кроме отдела 2,
- терминал 2 используется только для оплаты товаров из отдела 2 валютой с кодом 22:
  Пример настройки
```
[Main.22]
; Настройки процессинга Halyk
....
```
Валюта с кодом 5 – логическая валюта:
- указан параметр valut.mode = 2048.
Маппинг валют:
Пример настройки
```
[Processing.ValutMapping]
5 = 21, 22
```

При выборе логической валюты для оплаты чека инициируется последовательная оплата: товаров из отдела 1 – через терминал 1, товаров из отдела 2 – через терминал 2.

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

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

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

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

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

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

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

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

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

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

Логирование

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

Page tree

Halyk