Программа аркус для жкх инструкция

Модуль Аркус предназначен для выполнения оплаты платежными картами с использованием банковских терминалов и ПИН клавиатур. Оборудование предоставляется банками, которые используют данный процессинг.

Для установки и настройки модуля Аркус могут быть использованы:

• Руководство по установке Аркус
• Руководство администратора Аркус

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

• тип операции (оплата, возврат, сверка итогов и т.д.),
• сумма оплаты,
• дополнительные параметры операции.

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

Банковская квитанция получается от банковской системы и печатается 2 раза.

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

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

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

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

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

dpkg-reconfigure artix45-plugin-arcus

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

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

Файлы, необходимые для функционирования модуля располагаются в директории /linuxcash/cash/paysystems/arcus/.

Файлы клиентского приложения предоставляются сотрудниками банка. Одна из версий приложения входит в состав пакета, файлы приложения располагаются в директории /linuxcash/cash/paysystems/arcus/files/. Для использования данной версии приложения файлы из директории /linuxcash/cash/paysystems/arcus/files/ необходимо скопировать в директорию /linuxcash/cash/paysystems/arcus/.

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

Настройки приложения задаются в конфигурационном файле /linuxcash/cash/paysystems/arcus/artixarcus.conf.

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

Используемый тип процессинга необходимо указать в параметре processingType.

[main]
; Таймаут выполнения операций - оплата, возврат, отмена. В секундах, по-умолчанию 60.
;operationTimeout = 60
;Тип процессинга (допустимые значения: OpenWay, Compass), по умолчанию OpenWay
;processingType = OpenWay

Стыковка пин-пада с кассой

Для подключения пин-пада в файле /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

Настройка Ingenico iPP320

Для настройки Ingenico iPP320 необходимо:

1. Перезапустить пин-пад («Желтая кнопка» + «#»).
2. После вывода на экран слова STARTING через 1-2 секунды нажать клавишу «F».
3. Ввести пароль.
4. Настроить пин-пад, отвечая на вопросы приложения-настройщика:
   1. Работа с кассой? – да
   2. Port – USB
   3. SPEED – 9600
   4. IP через кассу? — нет (Понадобится дополнительный кабель ethernet, который будет подключён из MagicBox к сети.)
   5. Диалог на кассе? – нет
   6. Принт. на кассе? – да
   7. Ширина чека – 24
   8. Код авторизации с кассы? – нет
   9. Спец. маск.? – нет
   10. Печать журн? – да

Настройка IP адреса на пин-паде

Для настройки IP адреса пин-пада необходимо:

1. Вызвать в командной строке из директории /linuxcash/cash/paysystems/arcus исполняемый файл ./cashreg /o99.
2. Ввести пароль.
3. Выбрать Telium Manager.
4. Нажать F.
5. Выбрать Telium Manager.
6. Выбрать Initialization.
7. Выбрать Hardware.
8. Ethernet Setup.
9. Выполнить настройку ip, mask, gateway и т.д.

Использование одного терминала для одной и более организаций

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

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

aptitude install artix-arcusmultimerchant

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

dpkg-reconfigure artix-arcusmultimerchant

Файлы, необходимые для функционирования модуля, находятся в директории /linuxcash/cash/paysystems/arcusmultimerchant/. Модуль состоит из двух частей: библиотеки, которая предоставляется банком, и клиентского приложения (собственная разработка). Для корректного функционирования модуля файлы из директории /linuxcash/cash/paysystems/arcusmultimerchant/files/ необходимо скопировать в директорию /linuxcash/cash/paysystems/arcusmultimerchant/. Также файлы настроек модуля могут быть предоставлены сотрудниками банка.

Прочитать о настройке программы для оплаты несколькими юридическими лицами можно в статье «Банковские платежные системы».

Настройки процессинга

Настройки процессинга arcusmultimerchant задаются в конфигурационном файле /linuxcash/cash/paysystems/arcusmultimerchant/arcusmultimerchant.conf.

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

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

; Кодировка текстовых сообщений
; По умолчанию utf-8
;encoding = utf-8

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

Особенности использования терминала Аркус для нескольких юридических лиц

• Возврат товаров, оплаченных через терминал Аркус, может быть осуществлен только в режиме возврата по чеку продажи. При добавлении оплаты в чек возврата на экране отображается ошибка «Применение оплаты не доступно».
• В чеке возврата по чеку продажи запрещено сторнировать операцию по безналу, на экране отображается ошибка «Отмена оплаты не доступна».
• Сверка итогов по безналу производится общая по всем отделам. Печать отчетов по безналу производится отдельно на каждое юридическое лицо.
• При возврате по безналу в рамках текущей банковской смены осуществляется отмена операции оплаты. После снятия отчета по безналу в другой банковской смене возврат по безналу проходит запросом возврата.

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

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

Для возможности оплаты через процессинг Аркус по QR-коду на терминале необходимо:

1. В БД Dictionaries в таблице Valut настроить дополнительную валюту с параметром mode=4096.

2. В конфигурационный файл /linuxcash/cash/paysystems/arcusmultimerchant/rc_conv.ini внести настройки, предоставленные банком.

3. В конфигурационный файл /linuxcash/cash/paysystems/arcusmultimerchant/ops.ini добавить:

   #============ QR ===================
   102=1,109,Оплата QR
   103=1,110,Возврат QR

Логирование

Журнал вызовов клиентского приложения из кассовой программы ведется в основном логе /linuxcash/logs/current/terminal.log. Для идентификации данных, которые записаны данным модулем, используется логгер с именем payment. В журнал заносятся параметры вызова, результат выполнения и образ слипа, который предназначен для печати.