Panel | |
---|---|
|
Note | ||
---|---|---|
| ||
Реализованные сценарии работы:
|
Panel |
---|
Начиная с версии 4.6.202 значение параметра url необходимо задавать в виде "https://<localhost>/api". |
Модуль Raiffeisensbp предназначен для выполнения оплаты с помощью клиентского приложения. Покупателю необходимо отсканировать QR-код на с экрана кассы или распечатанного слипа. QR-код рассчитан только на 1 платёж.
...
платеж.
Типы поддерживаемых операций:
...
Для оплаты чека продажи покупателю необходимо отсканировать QR-код.
Warning |
---|
В случае неполучения успешного статуса оплаты кассой или других ошибках оплаты в подытоге, кассой формируется команда на отмену данного платежа. Оплата в чек при этом не добавляется. При обработке команды отмены повторно проверяется статус оплаты, и если на момент повторной проверки транзакция оплаты завершена успешно (получен статус о проведении платежа), то кассой генерируется запрос на возврат. Обращаем внимание на то, что команды на отмену и возврат платежа могут обрабатываться банком длительное время. По вопросам возврата денежных средств просим обращаться в банк. Также стоит учитывать следующее: |
Конфигурирование модуля
Для использования модуля необходимо установить пакет artix-raiffeisensbp
.
Code Block | ||
---|---|---|
| ||
aptitude install artix-raiffeisensbp |
Запрос к процессинговой системе Raiffeisensbp выполняется при выборе специального типа оплаты. Для добавления типа оплаты необходимо выполнить конфигурирование модуля. Номер типа оплаты задается в процессе конфигурирования.
Code Block | ||||
---|---|---|---|---|
| ||||
dpkg-reconfigure artix-raiffeisensbp |
...
Наименование | Тип данных | Описание | Примечания | ||||
---|---|---|---|---|---|---|---|
url | строковый | Адрес сервера | По умолчанию http://localhost . | ||||
timeout | целочисленный | Время ожидания ответа от сервера (в секундах) | По умолчанию 10 секунд. | ||||
sbpMerchantId | строковый | Идентификатор зарегистрированного | партнёрапартнера в СБП | ||||
secretKey | строковый | Секретный ключ для авторизации | |||||
currency | строковый | Валюта | По умолчанию RUB . | ||||
qrCodeLifetime | целочисленный | СрокCрок действия QR-кода (в | минутахсекундах) | По умолчанию | 15 минут Допустимые значения от | 1 минуты 20 секунд до 259200 | минут секунд (3-х дней). |
waitPaymentByQRCodeDuration | целочисленный | Время ожидания оплаты по QR-коду (в секундах) | По умолчанию 60 секунд. | ||||
intervalBetweenStatusRequests | целочисленный | Интервал между запросами статуса оплаты по QR-коду (в секундах) | По умолчанию | 60000 миллисекунд 1 секунда. | |||
getInfoDuration | целочисленный | Продолжительность выполнения запросов на получение информации по платежу или возврату (в секундах) | По умолчанию | 60000 миллисекунд 60 секунд. | |||
getInfoFrequency | целочисленный | Частота выполнения запросовИнтервал между запросами на получение информации по платежу или возврату | По умолчанию 10000 миллисекунд |
...
(в секундах) | По умолчанию 10 секунд. | ||
additionalInfoMask | строковый | Маска для поля дополнительной информации | По умолчанию "%(document.shopCode[04d])/%(document.cashCode[02d])/%(document.shift[04d])/%(document.num[07d]) ". |
staticQrId | строковый | Идентификатор статического QR-кода | Необходимы для оплаты с использованием статического QR-кода (кассовой ссылки) |
staticQrPayload | строковый | Данные статического QR-кода для отображения на кассе |
Code Block | ||||
---|---|---|---|---|
| ||||
[Main] ; Настройки процессинга Системы Быстрых Платежей (СБП) Райффайзен Банка ; Адрес сервера ; По умолчанию http://localhost ;url = http://localhost ; Время ожидания ответа от сервера (в секундах) ; По умолчанию 10 секунд ;timeout = 10 ; Идентификатор зарегистрированного партнёра в СБП ; По умолчанию "" ;sbpMerchantId = "" ; Секретный ключ для авторизации ; По умолчанию "" ;secretKey = "" ; Валюта ; По умолчанию "RUB" ;currency = "RUB" ; СрокCрок действия QR-кода в минутахсекундах ; Допустимые значения от 120 минутысекунд до 259200 минутсекунд (3-х дней) ; По умолчанию 1560 минутсекунд ;qrCodeLifetime = 1560 ; Время ожидания оплаты по QR-коду (в миллисекундахсекундах) ; По умолчанию 6000060 ;waitPaymentByQRCodeDuration = 60 ; Интервал между запросами статуса оплаты по QR-коду (в секундах) ; По умолчанию 1 ;intervalBetweenStatusRequests = 600001 ; Продолжительность выполнения запросов на получение информации по платежу или возврату (в миллисекундахсекундах) ; По умолчанию 6000060 ;getInfoDuration = 6000060 ; ЧастотаИнтервал выполнениямежду запросовзапросами на получение информации по платежу или возврату (в миллисекундахсекундах) ; По умолчанию 10000 ;getInfoFrequency = 1000010 ;getInfoFrequency = 10 ; Маска для поля дополнительной информации ; По умолчанию %(document.shopCode[04d])/%(document.cashCode[02d])/%(document.shift[04d])/%(document.num[07d]) ;additionalInfoMask = "%(document.shopCode[04d])/%(document.cashCode[02d])/%(document.shift[04d])/%(document.num[07d])" ; Идентификатор статического QR-кода ;staticQrId = "" ; Данные статического QR-кода для отображения на кассе ;staticQrPayload = "" |
Info |
---|
Процессинг работает только в одном из режимов: QR-код либо статический, либо динамический. При переключении режимов не будет работать возврат по чеку продажи. |
Передача данных об оплате
В кассовом ПО реализована возможность разрешать передачу данных об оплате в поле paymentDetails
с помощью параметра fillPaymentDetails
в конфигурационном файле /linuxcash/cash/paysystems/raiffeisensbp/raiffeisensbp.conf
в секции [Main]
:
- при значении
true
на сервер процессинга будет отправлен запрос, который содержит данные об оплате в json-формате "paymentDetails":"{\"identifier\":\"3478820800920000010\",\"sbpmerchantID\":\"MA0000039051\"}
", - при значении
false
данные об оплате переданы не будут.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
fillPaymentDetails | логический |
| Заполнять поле paymentDetails | По умолчанию true |
Code Block | ||||
---|---|---|---|---|
| ||||
[Main]
...
; Заполнять поле paymentDetails
; По умолчанию true
;fillPaymentDetails = true |
При закрытии чека в БД Documents
таблицу Moneyitem
в поле additionaldata
записывается идентификатор QR-кода оплаты в json-формате.
Печать QR-кода для оплаты
В кассовом ПО Artix реализована возможность печати слипа с QR-кодом для оплаты. Печать QR-кода задается параметром printQrPaymentSlip
в конфигурационном файле /linuxcash/cash/conf/ncash.ini
в секции [Check]
:
- при значении
true
будет осуществлена печать QR-кода на слипе, затем на экран будет выведен диалог "Отсканируйте QR-код для оплаты", - при значении
false
на экран будет выведен диалог "Отсканируйте QR-код для оплаты", печать слипа с QR-кодом не осуществляется.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
printQrPaymentSlip | логический |
| Печатать слип с QR-кодом для оплаты | По умолчанию false |
Code Block | ||||
---|---|---|---|---|
| ||||
[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 |
Code Block | ||||
---|---|---|---|---|
| ||||
[UI.ScanQrCodeForm.qrCode]
; Отображение QR-кода в форме оплаты по коду
; По умолчанию true
;visible = true |
Логирование
Журнал запросов к процессинговой системе Raiffeisensbp ведется в основном логе /linuxcash/logs/current/terminal.log
.