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

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

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

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

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

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

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

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

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

aptitude install artix-iturupsbp

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

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

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

НаименованиеТип данныхОписаниеПримечания
hostстроковыйАдрес сервераПо умолчанию 127.0.0.1
portцелочисленныйПорт сервераПо умолчанию 9443
timeoutцелочисленныйВремя ожидания ответа от сервера (в секундах)По умолчанию 10 секунд
tokenстроковыйТокен для авторизации
deviceIdстроковыйИдентификатор устройства торгово-сервисного предприятия для авторизации
accountстроковыйСчет участника системы быстрых платежей, на который будут зачислены средства
waitPaymentByQRCodeDurationстроковыйВремя ожидания оплаты по QR-коду (в секундах)По умолчанию 60 секунд
intervalBetweenStatusRequestsцелочисленныйИнтервал между запросами статуса оплаты по QR-коду (в секундах)По умолчанию 1 секунда
getInfoDurationцелочисленныйПродолжительность выполнения запросов на получение статуса операции (в секундах)По умолчанию 60 секунд
getInfoFrequencyцелочисленныйИнтервал между запросами на получение статуса операции (в секундах)По умолчанию 10 секунд
Пример настройки
[Main]
; Настройки процессинга системы быстрых платежей Итуруп Банка

; Адрес сервера
; По умолчанию 127.0.0.1
;host = 127.0.0.1

; Порт сервера
; По умолчанию 9443
;port = 9443

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

; Токен для авторизации
; По умолчанию ""
;token = ""

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

; Счет участника системы быстрых платежей, на который будут зачислены средства
; По умолчанию ""
;account = ""

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

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

; Продолжительность выполнения запросов на получение статуса операции (в секундах)
; По умолчанию 60
;getInfoDuration = 60

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

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

Логирование

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

  • No labels