Модуль Iturup предназначен для оплаты товаров, которые заведены в системе "Итуруп". Такие товары могут быть оплачены только картами (социальными сертификатами), зарегистрированными в системе "Итуруп".

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

оплата,
отмена оплаты.

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

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

aptitude install artix-iturup

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

dpkg-reconfigure artix-iturup

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

Наименование	Тип данных	Описание	Примечания
url	строковый	Адрес сервера	По умолчанию `http://localhost`
timeout	целочисленный	Время ожидания ответа от сервера (в секундах)	По умолчанию `20` секунд
catalogs	строковый	Список каталогов, в которых содержатся товары для оплаты через процессинг Итуруп
cashId	строковый	Шаблон уникального идентификатора кассы для отправки в процессинг	По умолчанию `%(document.shopCode[04d])`
inputCardMask	строковый	Маски для ввода карты	По умолчанию не задана
ico	строковый	Значок в товарной позиции для товаров, которые можно оплатить социальным сертификатом	По умолчанию `:basket_22x22.png`. Для корректной работы необходимо: задавать полный путь до файла с изображением, использовать изображения размером 22x22 пикселя.

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

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

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

; Список каталогов, в которых содержатся товары для оплаты через процессинг Итуруп
; По умолчанию ""
;catalogs = ""

; Шаблон уникального идентификатора кассы для отправки в процессинг
; По умолчанию %(document.shopCode[04d])
;cashId = %(document.shopCode[04d])

; Маски для ввода карты
; По умолчанию ""
;inputCardMask = ""

; Значок в товарной позиции для товаров, которые можно оплатить социальным сертификатом
; По умолчанию :basket_22x22.png
;ico = :basket_22x22.png

Оплата чека

Допускается только полная оплата товара процессингом "Итуруп".

Для возможности оплаты чека необходимо:

Установить и настроить процессинг "Итуруп" (см. "Конфигурирование модуля").
Добавить товары, которые заведены в системе "Итуруп", в каталоги.
Необходимо использовать каталоги, указанные в параметре catalogs.
Перезапустить кассу.
Добавить товары, которые заведены в системе "Итуруп", в чек.
Выбрать тип оплаты "Iturup".
Добавить карту в чек.
Выполнить оплату.

Особенности работы

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

После считывания данных карты в процессинг "Итуруп" отправляется запрос на резервирование средств. При успешном выполнении запроса на резервирование средств оплата добавляется в чек. При закрытии чека через очередь в процессинг "Итуруп" отправляется запрос на подтверждение списания ранее зарезервированных средств. Если баланс карты меньше суммы чека, то будет выведена ошибка, оплата выполнена не будет. После успешной оплаты идентификационный номер операции (поле operationid) и номер карты (поле cardnum) сохраняются в БД Documents таблицу Moneyitem.

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

Логирование

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