Реализованные сценарии работы:

  • динамический QR-код,
  • работа с кассовой ссылкой.

Модуль Paygine предназначен для выполнения оплаты с помощью сканирования QR-кода. Покупателю необходимо отсканировать QR-код с экрана кассы или распечатанного слипа. QR-код рассчитан только на 1 платеж. После сканирования QR-кода осуществляется переход на веб-страницу, где покупателю необходимо выбрать способ оплаты.

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

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

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

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

aptitude install artix-paygine

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

Конфигурирование модуля
dpkg-reconfigure artix-paygine

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

НаименованиеТип данныхОписаниеПримечания
urlстроковыйАдрес сервераПо умолчанию http://localhost
timeoutцелочисленныйВремя ожидания ответа от сервера (в секундах)По умолчанию 60
waitPaymentByQRCodeDurationцелочисленныйВремя ожидания оплаты по QR-коду (в секундах)По умолчанию 60
statusRequestIntervalцелочисленныйИнтервал между запросами статуса оплаты по QR-коду (в секундах)По умолчанию 5
sectorстроковыйИдентификатор сектораПо умолчанию ""
passwordстроковыйПароль для формирования цифровой подписиПо умолчанию ""
currencyстроковыйКод валюты операцииПо умолчанию 643
mtdRefстроковыйИдентификатор кассовой ссылки

По умолчанию ""

Настройки необходимы для оплаты с использованием статического QR-кода (кассовой ссылки)

staticQrстроковыйКассовая ссылка
orderDescriptionMaskстроковыйМаска описания заказаПо умолчанию "Заказ Артикс. Магазин %(document.shopCode[s]), касса %(document.cashCode[s])"
referenceMaskстроковыйМаска номера заказа на стороне кассыПо умолчанию "%(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(document.dateTimeBeg[hhmmss])"
Пример настройки
[Paygine]
; Настройки процессинга Paygine Method

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

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

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

; Интервал между запросами статуса оплаты по QR-коду (в секундах)
; По умолчанию 5
;statusRequestInterval = 5

; Идентификатор сектора
; По умолчанию ""
;sector = ""

; Пароль для формирования цифровой подписи
; По умолчанию ""
;password = ""

; Код валюты операции
; По умолчанию 643
;currency = 643

; Идентификатор кассовой ссылки
; Используется для регистрации заказа при работе в режиме кассовой ссылки
; По умолчанию ""
;mtdRef = ""

; Кассовая ссылка
; По умолчанию ""
;staticQr = ""

; Маска описания заказа
; По умолчанию "Заказ Артикс. Магазин %(document.shopCode[s]), касса %(document.cashCode[s])"
;orderDescriptionMask = "Заказ Артикс. Магазин %(document.shopCode[s]), касса %(document.cashCode[s])"

; Маска номера заказа на стороне кассы
; По умолчанию "%(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(document.dateTimeBeg[hhmmss])"
;referenceMask = "%(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(document.dateTimeBeg[hhmmss])"

Печать QR-кода для оплаты

В кассовом ПО Artix реализована возможность печати слипа с QR-кодом для оплаты. Печать QR-кода задается параметром printQrPaymentSlip в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [Check]:

  • при значении true будет осуществлена печать QR-кода на слипе, затем на экран будет выведен диалог "Отсканируйте QR-код для оплаты",
  • при значении false на экран будет выведен диалог "Отсканируйте QR-код для оплаты", печать слипа с QR-кодом не осуществляется.
НаименованиеТип данныхВозможные значенияОписаниеПримечания

printQrPaymentSlip

логический
  • true
  • false
Печатать слип с QR-кодом для оплатыПо умолчанию false
Пример настройки
[Check]
...
; Печатать слип с QR-кодом для оплаты
; По умолчанию false
;printQrPaymentSlip = false

Отображение QR-кода на экране

В кассовом ПО Artix реализована возможность отображения QR-кода в форме оплаты. Отображение QR-кода задается параметром visible в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/gui.ini в секции [UI.ScanQrCodeForm.qrCode]:

  • при значении true на экран будет выведен диалог сканирования QR-кода, QR-код отображен в диалоге,
  • при значении false на экран будет выведен диалог сканирования QR-кода, QR-код не отображен в диалоге.
НаименованиеТип данныхВозможные значенияОписаниеПримечания

visible

логический
  • true
  • false
Отображение QR-кода в форме оплаты по кодуПо умолчанию true
Пример настройки
[UI.ScanQrCodeForm.qrCode]
; Отображение QR-кода в форме оплаты по коду
; По умолчанию true
;visible = true

Логирование

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

  • No labels