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

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

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

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

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

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

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

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

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

aptitude install artix-yandexsbp

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

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

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

НаименованиеТип данныхОписаниеПримечания
urlстроковыйАдрес сервераПо умолчанию http://localhost
timeoutцелочисленныйВремя ожидания ответа от сервера (в секундах)По умолчанию 60 секунд
paymentByQrDurationцелочисленныйВремя ожидания оплаты (в секундах)По умолчанию 300 секунд
statusRequestIntervalцелочисленныйИнтервал запроса статуса заказа (в секундах)По умолчанию 10 секунд
tokenстроковыйКлюч продавца
returnUrlстроковыйАдрес, на который будет перенаправлен клиент после оплаты


Пример настройки
[YandexSbp]
; Настройки процессинга Яндекс СБП

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

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

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

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

; Ключ продавца 
; По умолчанию ""
;token = ""

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

Передача комментария к платежу

В кассовом ПО Artix реализована передача комментария при оплате чека продажи. Маска комментария задается параметром commentMask в конфигурационном файле /linuxcash/cash/paysystems/yandexspb/yandexspb.ini в секции [YandexSbp].

НаименованиеТип данныхОписаниеПримечания
commentMaskстроковыйМаска комментария к платежуПо умолчанию "%(document.shopCode[04d]) %(document.cashCode[02d])"
Пример настройки
[YandexSbp]
...
; Маска комментария к платежу
; По умолчанию "%(document.shopCode[04d]) %(document.cashCode[02d])"
;commentMask = "%(document.shopCode[04d]) %(document.cashCode[02d])"

Выбор кассовой ссылки для оплаты по cтатическому QR-коду

В кассовом ПО Artix существует возможность выбора кассовой ссылки для оплаты по статическому QR-коду. Для выбора кассовой ссылки по идентификатору в утилите администрирования Yuki необходимо на пункт меню настроить действие "Выбор кассовой ссылки" с командой COMMAND_PROCESSING_SELECTSTATICQR. О настройке действий подробнее можно прочитать в разделе "Настройка действий". 

Если кассовая ссылка не была выбрана, то оплата будет произведена по динамическому QR-коду.

При вызове действия "Выбор кассовой ссылки" на экран будет выведен список идентификаторов кассовых ссылок. Кассовая ссылка может быть выбрана из списка или отсканирована. При сканировании кассовой ссылки соответствующий идентификатор будет выбран автоматически. Если идентификатор кассовой ссылки отсканирован корректно, то на экран будет выведено сообщение об успешном сканировании кассовой ссылки, после чего будет создан конфигурационный файл /linuxcash/cash/paysystems/yandexsbp/staticqr.ini с настройкой staticQrId.

Пример настройки
[yandexsbp]
staticQrId = AS2R0027B3GEPD1V8KM8UICJDOTEBJCJ

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

Логирование

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

  • No labels