Реализованные сценарии работы:
- динамический 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 | логический |
| Печатать слип с 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 | логический |
| Отображение QR-кода в форме оплаты по коду | По умолчанию true |
[UI.ScanQrCodeForm.qrCode] ; Отображение QR-кода в форме оплаты по коду ; По умолчанию true ;visible = true
Логирование
Журнал запросов к процессинговой системе Paygine ведется в основном логе /linuxcash/logs/current/terminal.log
.