Модуль ClickPass предназначен для выполнения оплаты с помощью клиентского приложения Click, которое генерирует QR-код для оплаты. QR-код рассчитан только на 1 платёж, повторно совершить платеж по QR-коду невозможно.

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

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

Для оплаты чека продажи необходимо отсканировать QR-код. Итоговая сумма чека продажи не должна быть меньше установленного сервером лимита.

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

Частичный возврат по чеку продажи запрещен.

При возврате по чеку продажи, содержащему маркированные или акцизные товары (алкогольную или табачную продукцию, обувные товары или лекарственные препараты), необходимо:

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

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

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

aptitude install artix-clickpass

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

dpkg-reconfigure artix-clickpass

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

Обязательное подтверждение оплаты задается параметром confirmMode:

при значении true операция оплаты требует дополнительного подтверждения, иначе она будет автоматически отменена через 30 секунд (на стороне процессинга),
при значении false операция оплаты не требует дополнительного подтверждения.

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

Если не удалось установить требуемый режим подтверждения, операция оплаты будет прервана.

Наименование	Тип данных	Возможные значения	Описание	Примечания
timeout	целочисленный		Время ожидания ответа от сервера (в секундах)	По умолчанию `10` секунд
url	строковый		Адрес сервера	По умолчанию `http://localhost`
serviceId	целочисленный		Идентификатор сервиса
confirmMode	логический	true false	Обязательное подтверждение операции	По умолчанию `true`
secretKey	строковый		Секретный ключ
merchantUserId	целочисленный		Идентификатор пользователя
paymentProvider	целочисленный		Код провайдера услуг по оплате по QR-коду	По умолчанию `64`

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

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

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

; Идентификатор сервиса
;serviceId = ""

; Обязательное подтверждение операции
; По умолчанию true
;confirmMode = true

; Секретный ключ
;secretKey = ""

; Идентификатор пользователя
;merchantUserId = ""

; Код провайдера услуг по оплате по QR-коду
; По умолчанию 64
;paymentProvider = 64

Логирование

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