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

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

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

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

В случае неполучения успешного статуса оплаты кассой или других ошибках оплаты в подытоге, кассой формируется команда на отмену данного платежа. Оплата в чек при этом не добавляется. При обработке команды отмены повторно проверяется статус оплаты, и если на момент повторной проверки транзакция оплаты завершена успешно (получен статус о проведении платежа), то кассой генерируется запрос на возврат.

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

Также стоит учитывать следующее:
1. Информация на смартфоне клиента не является фактом подтверждения платежа и может быть недействительной.
2. Подтверждением платежа является только получение ПО Artix информации об успешном прохождении оплаты.

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

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

aptitude install artix-mtsdrsbp

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

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

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

НаименованиеТип данныхОписаниеПримечания
urlстроковыйАдрес сервераПо умолчанию http://localhost
tokenUrlстроковыйАдрес сервера авторизацииПо умолчанию http://localhost
timeoutцелочисленныйВремя ожидания ответа от сервера (в секундах)По умолчанию 60 секунд
paymentByQrDurationцелочисленныйВремя ожидания оплаты заказа (в секундах)По умолчанию 300 секунд
statusRequestIntervalцелочисленныйИнтервал запроса статуса заказа (в секундах)По умолчанию 10 секунд
clientIdстроковыйИдентификатор клиента
userNameстроковыйИмя пользователя
passwordстроковыйПароль
currencyстроковыйКод валютыПо умолчанию 643
redirectUrlстроковыйАдрес, на который будет перенаправлен клиент после оплаты
realmIdстроковыйИдентификатор вызывающей системыПо умолчанию "pos" 
merchantIdстроковыйИдентификатор ТСП в СБП
orgIdстроковыйУникальный ID юр.лица
paymentServiceIdстроковыйПризнак способа приема платежа

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

Пример настройки
[MtsSbp]
; Настройки процессинга МТС ЦР СБП

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

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

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

; Время ожидания оплаты заказа (в секундах)
; По умолчанию 300 секунд
;paymentByQrDuration = 300

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

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

; Имя пользователя
; По умолчанию "" 
;userName = "" 

; Пароль
; По умолчанию "" 
;password = "" 

; Валюта
; По умолчанию "643" 
;currency = "643" 

; Адрес, на который будет перенаправлен клиент после оплаты
; По умолчанию "" 
;redirectUrl = "" 

; Идентификатор вызывающей системы
; По умолчанию "pos" 
;realmId = "pos" 

; Идентификатор ТСП в СБП
; По умолчанию "" 
;merchantId = "" 

; Уникальный ID юр.лица
; По умолчанию "" 
;orgId = "" 

; Признак способа приема платежа
; По умолчанию "PS0000000002" 
;paymentServiceId = "PS0000000002"

Печать 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

Логирование

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

  • No labels