Модуль Аркус предназначен для выполнения оплаты платежными картами с использованием банковских терминалов и ПИН клавиатур. Оборудование предоставляется банками, которые используют данный процессинг.
Поддерживаемое оборудование:
|
Для установки и настройки модуля Аркус могут быть использованы:
Модуль представляет собой клиентское приложение cashreg
и набор конфигурационных файлов, необходимых для обращения к процессинговому центру. При проведении оплаты платежной картой, кассовая программа использует функции приложения cashreg
. Параметрами для этого приложения передаются:
После завершения работы приложения, создаются файлы с результатом выполнения операции и образом квитанции для печати. Кассовая программа анализирует результат выполнения и при необходимости печатает на чековой ленте содержимое печатного образа.
Банковская квитанция получается от банковской системы и печатается 2 раза.
Типы поддерживаемых операций:
В кассовом ПО Artix модуль Аркус может быть установлен посредством пакета artix-arcusmultimerchant
со следующими возможностями:
Для использования модуля необходимо установить пакет artix-arcusmultimerchant
.
aptitude install artix-arcusmultimerchant |
Вызов клиентского приложения выполняется при выборе специального типа оплаты. Для добавления типа оплаты необходимо выполнить конфигурирование модуля. Номер типа оплаты задается в процессе конфигурирования.
dpkg-reconfigure artix-arcusmultimerchant |
Файлы, необходимые для функционирования модуля, находятся в директории /linuxcash/cash/paysystems/arcusmultimerchant/
. Модуль состоит из двух частей: библиотеки, которая предоставляется банком, и клиентского приложения (собственная разработка). Для корректного функционирования модуля файлы из директории /linuxcash/cash/paysystems/arcusmultimerchant/files/
необходимо скопировать в директорию /linuxcash/cash/paysystems/arcusmultimerchant/
. Также файлы настроек модуля могут быть предоставлены сотрудниками банка.
Прочитать о настройке программы для оплаты несколькими юридическими лицами можно в статье "Банковские платежные системы".
Для подключения пин-пада в файле /linuxcash/cash/paysystems/arcus/cashreg.ini
необходимо указать порт подключения пин-пада и настройки работы:
#port section PORT=/dev/ttyACM0 # SPDH/Compass Plus # OPERATION_INI_FILE=ops_spdh.ini # RC_CONVERT_FILE=rc_conv_spdh.ini # RC_RESOLVE_FILE=rc_res_spdh.ini #ISO8583-SmartVista/OpenWay/Tieto OPERATION_INI_FILE=ops_8583.ini RC_CONVERT_FILE=rc_conv_8583.ini RC_RESOLVE_FILE=rc_res_8583.ini |
Настройки процессинга arcusmultimerchant
задаются в конфигурационном файле /linuxcash/cash/paysystems/arcusmultimerchant/
arcusmultimerchant.conf
.
Для корректного отображения текстовых сообщений необходимо в настройках процессинга указать кодировку с помощью параметра encoding
.
Убедитесь, что следующие кодировки совпадают:
|
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
encoding | строковый | Кодировка текстовых сообщений | По умолчанию utf-8 |
timeout | целочисленный | Время ожидания ответа от пин-пада | По умолчанию 300 секунд |
currency | целочисленный | Код валюты операции | По умолчанию 643 |
[Main] ; Настройки процессинга arcusmultimerchant ; Кодировка текстовых сообщений ; По умолчанию utf-8 ;encoding = utf-8 ; Время ожидания ответа от пин-пада (в секундах) ; По умолчанию 300 секунд ;timeout = 300 ; Код валюты операции ; По умолчанию 643 ;currency = 643 |
Начиная с версии 4.6.254 кассового ПО реализована возможность работы процессинга Аркус одновременно с несколькими терминалами. |
Для настройки дополнительных терминалов Аркус необходимо:
/linuxcash/cash/paysystems/arcusmultimerchant
в новую директорию.payprocdir
путь до рабочей директории процессинга.В кассовом ПО Artix реализована возможность оплаты через процессинг по QR-коду на терминале.
Убедитесь в том, что на терминале установлена прошивка, поддерживающая возможность оплаты по QR-коду. |
Для возможности оплаты через процессинг Аркус по QR-коду на терминале необходимо:
Dictionaries
в таблице Valut
настроить дополнительную валюту с параметром mode=
4096
.В конфигурационный файл /linuxcash/cash/paysystems/arcusmultimerchant/rc_conv.ini
внести настройки, предоставленные банком.
В конфигурационный файл /linuxcash/cash/paysystems/arcusmultimerchant/
ops.ini
добавить:
#============ QR =================== 102=1,109,Оплата QR 103=1,110,Возврат QR |
Для настройки Ingenico iPP320 необходимо:
Для настройки IP адреса пин-пада необходимо:
/linuxcash/cash/paysystems/arcus
исполняемый файл ./cashreg /o99
.Для настройки пин-пада необходимо:
Включить параметр splitPaymentToMerchants
в конфигурационном файле /linuxcash/cash/conf/ncash.ini
в секции [Check
]:
[Check] ; ; Настройки чека ; ... ; Разбивать платеж по безналичному расчету по нескольким юридическим лицам ; По умолчанию – false splitPaymentToMerchants = true |
Настроить соотнесение отделов на пин-паде и в кассе в конфигурационном файле /linuxcash/cash/conf/ncash.ini
в секции [HW.PINPAD.DepartMapping]
:
[HW.PINPAD.DepartMapping] 000000008 = 1,2 |
, где <id_пин-пада
> = <номера отдела
>.
Для автоматического подключения пин-пада необходимо:
Создать файл /etc/udev/rules.d/97-pax.rules
и указать в нем правило:
SUBSYSTEM=="tty", ACTION=="add", ENV{ID_VENDOR_ID}=="2fb8", ENV{ID_MODEL_ID}=="2365", ENV{ID_USB_INTERFACE_NUM}=="01", SYMLINK+="ttyPax" |
Для вступления правила в силу необходимо перезагрузить кассу либо выполнить команду:
udevadm control --reload-rules && udevadm trigger |
Согласно правилу при подключении пин-пада в директории /dev/
автоматически будет создана символьная ссылка ttyPax
.
Для проверки факта создания символьной ссылки можно воспользоваться командой:
ls /dev/tty* |
В конфигурационном файле /linuxcash/cash/paysystems/arcusmultimerchant/cashreg.ini
параметру PORT
необходимо задать путь до созданной ссылки /dev/ttyPax
:
#port section PORT=/dev/ttyPax #PORT=/dev/ttyS0 SPEED=115200 BYTE=8 PARITY=N STOP=1 |
Журнал вызовов клиентского приложения из кассовой программы ведется в основном логе /linuxcash/logs/current/terminal.log
. Для идентификации данных, которые записаны данным модулем, используется логгер с именем payment
. В журнал заносятся параметры вызова, результат выполнения и образ слипа, который предназначен для печати.