Модуль Плати QR предназначен для выполнения оплаты с помощью клиентского приложения СберБанк Онлайн. Покупателю необходимо отсканировать QR-код с экрана кассы или распечатанного слипа. QR-код рассчитан только на 1 платёж.
Типы поддерживаемых операций:
Для оплаты чека продажи покупателю необходимо отсканировать QR-код и подтвердить оплату в клиентском приложении СберБанк Онлайн.
В кассовом ПО Artix модуль Плати QR может быть установлен посредством пакетов
|
В случае неполучения успешного статуса оплаты кассой или других ошибках оплаты в подытоге, кассой формируется команда на отмену данного платежа. Оплата в чек при этом не добавляется. При обработке команды отмены повторно проверяется статус оплаты, и если на момент повторной проверки транзакция оплаты завершена успешно (получен статус о проведении платежа), то кассой генерируется запрос на возврат. Обращаем внимание на то, что команды на отмену и возврат платежа могут обрабатываться банком длительное время. По вопросам возврата денежных средств просим обращаться в банк. Также стоит учитывать следующее: |
Для кассового ПО Artix на базе Ubuntu 22.04 функционал не поддержан. |
Для использования модуля необходимо установить пакет artix-platiqr
.
aptitude install artix-platiqr |
Запрос к процессинговой системе Плати QR выполняется при выборе специального типа оплаты. Для добавления типа оплаты необходимо выполнить конфигурирование модуля. Номер типа оплаты задается в процессе конфигурирования.
dpkg-reconfigure artix-platiqr |
Настройки процессинга задаются в файле /linuxcash/cash/paysystems/platiqr/platiqr.conf
в секции [Main]
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
url | строковый | Адрес сервера | По умолчанию http://localhost |
timeout | целочисленный | Время ожидания ответа от сервера (в секундах) | По умолчанию 10 секунд |
clientId | строковый | clientId для подключения | |
clientSecret | строковый | clientSecret для подключения | |
idQr | строковый | IdQr устройства, на котором сформирован заказ | |
memberId | строковый | Идентификатор клиента | |
currency | строковый | Валюта операции | По умолчанию RUB |
waitPaymentByQRCodeDuration | целочисленный | Время ожидания оплаты по QR-коду (в секундах) | По умолчанию 60 секунд |
intervalBetweenStatusRequests | целочисленный | Интервал между запросами статуса оплаты по QR-коду (в секундах) | По умолчанию 1 секунда |
getInfoDuration | целочисленный | Продолжительность выполнения запросов на получение информации по оплате заказа (в секундах) | По умолчанию 60 секунд |
getInfoFrequency | целочисленный | Интервал между запросами на получение информации по оплате заказа (в секундах) | По умолчанию 10 секунд |
certificatePath | строковый | Путь к сертификату | |
certificatePassword | строковый | Пароль к сертификату |
[Main] ; Настройки процессинга Плати QR ; Адрес сервера ; По умолчанию http://localhost ;url = http://localhost ; Время ожидания ответа от сервера (в секундах) ; По умолчанию 10 секунд ;timeout = 10 ; clientId для подключения ; По умолчанию "" ;clientId = "" ; clientSecret для подключения ; По умолчанию "" ;clientSecret = "" ; IdQr устройства, на котором сформирован заказ ; По умолчанию "" ;idQr = "" ; Идентификатор клиента ; По умолчанию "" ;memberId = "" ; Валюта операции ; По умолчанию "RUB" ;currency = "RUB" ; Время ожидания оплаты по QR-коду (в секундах) ; По умолчанию 60 ;waitPaymentByQRCodeDuration = 60 ; Интервал между запросами статуса оплаты по QR-коду (в секундах) ; По умолчанию 1 ;intervalBetweenStatusRequests = 1 ; Продолжительность выполнения запросов на получение информации по оплате заказа (в секундах) ; По умолчанию 60 ;getInfoDuration = 60 ; Интервал между запросами на получение информации по оплате заказа (в секундах) ; По умолчанию 10 ;getInfoFrequency = 10 ; Путь к сертификату ; По умолчанию "" ;certificatePath = "" ; Пароль к сертификату ; По умолчанию "" ;certificatePassword = " |
Для использования модуля необходимо установить пакет artix-platiqr3
.
aptitude install artix-platiqr3 |
Запрос к процессинговой системе Плати QR выполняется при выборе специального типа оплаты. Для добавления типа оплаты необходимо выполнить конфигурирование модуля. Номер типа оплаты задается в процессе конфигурирования.
dpkg-reconfigure artix-platiqr3 |
Настройки процессинга задаются в файле /linuxcash/cash/paysystems/platiqr3/platiqr3.conf
в секции [Main]
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
url | строковый | Адрес сервера | По умолчанию http://localhost |
timeout | целочисленный | Время ожидания ответа от сервера (в секундах) | По умолчанию 10 секунд |
clientId | строковый | clientId для подключения | |
clientSecret | строковый | clientSecret для подключения | |
idQr | строковый | IdQr устройства, на котором сформирован заказ | |
memberId | строковый | Идентификатор клиента | |
tid | строковый | Идентификатор терминала | |
currency | строковый | Код валюты операции | По умолчанию 643 |
waitPaymentByQRCodeDuration | целочисленный | Время ожидания оплаты по QR-коду (в секундах) | По умолчанию 60 секунд |
intervalBetweenStatusRequests | целочисленный | Интервал между запросами статуса оплаты по QR-коду (в секундах) | По умолчанию 5 секунд |
getInfoDuration | целочисленный | Продолжительность выполнения запросов на получение информации по оплате заказа (в секундах) | По умолчанию 60 секунд |
getInfoFrequency | целочисленный | Интервал между запросами на получение информации по оплате заказа (в секундах) | По умолчанию 10 секунд |
specialSymbolsMask | строковый | Маска, задающая специальные символы для удаления из поля 'position_name' внутри тела запроса /creation | По умолчанию При значении по умолчанию из поля '
|
certificatePath | строковый | Путь к сертификату | |
certificatePassword | строковый | Пароль к сертификату |
[Main] ; Настройки процессинга Плати QR ; Адрес сервера ; По умолчанию http://localhost ;url = http://localhost ; Время ожидания ответа от сервера (в секундах) ; По умолчанию 10 секунд ;timeout = 10 ; clientId для подключения ; По умолчанию "" ;clientId = "" ; clientSecret для подключения ; По умолчанию "" ;clientSecret = "" ; IdQr устройства, на котором сформирован заказ ; По умолчанию "" ;idQr = "" ; Идентификатор клиента ; По умолчанию "" ;memberId = "" ; Идентификатор терминала ; По умолчанию "" ;tid = "" ; Код валюты операции ; По умолчанию 643 ;currency = 643 ; Время ожидания оплаты по QR-коду (в секундах) ; По умолчанию 60 ;waitPaymentByQRCodeDuration = 60 ; Интервал между запросами статуса оплаты по QR-коду (в секундах) ; По умолчанию 5 ;intervalBetweenStatusRequests = 5 ; Продолжительность выполнения запросов на получение информации по оплате заказа (в секундах) ; По умолчанию 60 ;getInfoDuration = 60 ; Интервал между запросами на получение информации по оплате заказа (в секундах) ; По умолчанию 10 ;getInfoFrequency = 10 ; Маска, задающая специальные символы для удаления из поля 'position_name' внутри тела запроса /creation ; По умолчанию "[^а-яА-Я\w\s]" ;specialSymbolsMask = "[^а-яА-Я\w\s]" ; Путь к сертификату ; По умолчанию "" ;certificatePath = "" ; Пароль к сертификату ; По умолчанию "" ;certificatePassword = "" |
В кассовом ПО Artix реализована возможность печати слипа с QR-кодом для оплаты. Печать QR-кода задается параметром printQrPaymentSlip
в конфигурационном файле /linuxcash/cash/conf/ncash.ini
в секции [Check]
:
true
будет осуществлена печать QR-кода на слипе, затем на экран будет выведен диалог "Отсканируйте QR-код для оплаты";false
на экран будет выведен диалог "Отсканируйте QR-код для оплаты", печать слипа с QR-кодом не осуществляется.Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
printQrPaymentSlip | логический |
| Печатать слип с QR-кодом для оплаты | По умолчанию false |
[Check] ... ; Печатать слип с QR-кодом для оплаты ; По умолчанию false ;printQrPaymentSlip = false |
В кассовом ПО 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 |
Журнал запросов к процессинговой системе Плати QR ведется в основном логе /linuxcash/logs/current/terminal.log
.