Публичное пространство

Оплата QR-кодом: Альфабанк СБП (Система Быстрых Платежей)

SRTZ-1838 - Получение подробных данных проблемы… СТАТУС

CR-7448 - Получение подробных данных проблемы… СТАТУС

10.3.17.0

Описание

Возможность подключить на кассе оплату через Систему Быстрых Платежей "Альфа-Банк", используя QRC, расположенный в кассовой зоне, чтобы иметь возможность применять оплату по QR-коду из мобильных приложений банков-участников.

Настройка

Сервер

1. Перейдите в Интеграция → Внешние процессинги → кликните .

2. Наберите в строке поиска альфа → кликните Сервисы оплаты по QR-коду → установите флажок Альфабанк (СБП) → кликните .

3. Кликните по процессингу Альфабанк (СБП).

4. Введите данные в поля → кликните .

ПараметрОписаниеПример значения
Закрытый RSA ключ клиента в base64

Сертификат ключа клиента, когда он предоставлен Альфабанком

  • В случаях, когда у клиента tcnm ключ клиента и ключ банка необходимо их прописать в соответствующие поля.
  • В случае, когда у клиента нет своего ключа, но имеется только ключ банка необходимо продублировать этот ключ и в поле ключа клиента и в поле ключа банка/
  • Какие ключи будут у клиента зависит от договоренности между клиентом и Альфабанком.
Сертификат в формате base64
Сертификат X.509 банка в base64Сертификат для подписи запроса при подключении к TLS шлюзу.Пример файла сертификата cert.crt
Закрытый RSA ключ банка в base64Закрытый ключ для валидации подписи сертификата.Пример файла закрытого ключа key.key
Имя сертификата на стороне АльфабанкаНаименование сертификата, выдаваемое Альфабанком для каждого сертификата.c2b-pos-test
Идентификатор зарегистрированного партнера в СБП

Идентификационный номер, предоставляемый банком для магазина в системе СБП.

Внимание! При заполнении «Идентификатора зарегистрированного партнера в СБП» вводите идентификатор юридического лица, а не торгово-сервисной точки. В противном случае вы не можете зарегистрировать другие свои ТСТ в рамках одного юридического лица. Таким образом прием платежей СБП будет происходить только по одной ТСТ. А ТСТ в рамках юридического лица может быть гораздо более одного.

MA0000002371
Назначение платежа (отображается в выписке)

Данные для протокола обмена с процессингом Альфабанк СБП, в котором присутствует секция paymentDetails, которую банк отображает в выписке, передаваемой ритейлеру.

Допустимые значения:

  • Простой текст.
  • Переменные (мнемоники):
    • %SHOP_INDEX% - номер магазина.
    • %CASH_NUMBER% - номер кассы.
    • %DATE_TIME% - дата и время формирования запроса в формате ISO-8601 (например, 2021-04-15T13:12:12).
Оплата по СБП
Срок действия QR-кода в минутахСрок в течение которого будет действителен сгенерированный QR-код оплаты на экране или на чеке.5
Максимальное время ожидания при подключении в секундахТаймаут подключения в секундах10
Максимальное время ожидания ответа в секундахТаймаут ожидания ответа в секундах10

5. Откройте на редактирование файл сертификата .crt, полученный от Альфабанка, в текстовом редакторе (рекомендуется в Notepad++).

6. Удалите строки заголовков ----BEGIN CERTIFICATE----, ----END CERTIFICATE----

7. Выделите весь текст, нажав комбинацию клавиш CTRL + A.

8. Перейдите в меню Поиск → выберите Замена... → введите в поле поиска Найти: значение \n → установите переключатель в положение Расширенный → кликните Заменить все.

9. Скопируйте содержимое в буфер обмена для вставки в поле Сертификат .crt в формате base64

10. Повторите операции 5-9 для файла закрытого ключа .key → поместите содержимое в поле Закрытый ключ .key в формате base64.

Настройка кассового модуля

1. Перейдите в Кассовый модуль → кликните Шаблоны касс → рядом с тем шаблоном касс, для которого требуется назначить оплату QR-кодом нажмите  → выберите Редактировать.

2. Перейдите на вкладку ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → введите в строку поиска код → кликните по секции Типы оплат → установите флажок  Оплата по QR-коду → кликните .

Добавление банка

1. Перейдите в раздел Кассовый модуль → кликните Банки → кликните .

2. Введите в поле Название наименование отображаемого банка на кассе с пометкой СБП → выберите из поля со списком процессинг Альфабанк (СБП) → нажмите Добавить.

3. Банк добавится в список.

Назначение функциональных клавиш и пунктов меню клавиатурной кассы

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

Клавиша прикассовой клавиатуры

1. Перейдите в раздел Кассовый модуль → кликните Кассовое оборудование → нажмите кнопку редактирования шаблона клавиатуры.

2. Назначьте тип оплаты Оплата по QR-коду → в наименовании банка выберите Альфабанк (СБП) → введите название кнопки → нажмите Сохранить.

Кассовое меню

1. Перейдите в Кассовый модуль → кликните Шаблоны касс → рядом с тем шаблоном касс, для которого требуется назначить оплату QR-кодом нажмите  → выберите Редактировать.

2. Перейдите на вкладку НАСТРОЙКА МЕНЮ → нажмите .

3. Назначьте тип оплаты Оплата по QR-коду → в наименовании банка выберите Альфабанк (СБП) → нажмите Применить.

Касса

Настройка конфигурационного файла процессинга (для всех типов касс)

1. Отройте на редактирование файл /storage/crystal-cash/config/plugins/bank-alfabank_sbp-config.xml:

Установите идентификаторы терминала и QRC кассовой ссылки в параметры terminalNo и cashLinkQrId, которые выдаются представителем Альфабанка.

Если необходимо настроить проведение тестовых оплат на стенде, тогда добавьте также строку с параметром <property key="url" value="TEST"/>

Клавиатурная касса

Настройка конфигурационного файла для вывода QR-кода оплаты на дисплей покупателя 

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

Если к клавиатурной кассе подключен LCD-дисплей покупателя, тогда можно установить параметры вывода QR-кода для сканирования его покупателем.

1. Откройте на редактирование файл crystal-cash/config/plugins/payments-bankQR-config.xml:

2. Установите параметр showQROnCheckDisplay = true.

Настройка подключения к процессингу

1. Переключитесь на экран визуализации кассового модуля. 

2. Перейдите в кассовой меню → выберите Конфигуратор.

3. Выберите Банки.

4. Выберите Альфабанк (СБП).

5. Нажмите Задействовать.

6. Нажмите ОТМЕНА → Перезагрузите кассовый модуль.

SetTouch

1. Нажмите Настройки.

2. Нажмите Банки.

3. Выберите Альфабанк (СБП).

4. Включите использование процессинга.

5. Вернитесь на предыдущий экран.

6. Перезагрузите кассовый модуль.

Пример работы

Оплата по QR-коду происходит стандартным образом, как и на других процессингах.

Оплата с помощью QR ссылки:

  1. Кассир добавляет товары в чек;

  2. Кассир переходит в режим Оплаты;

  3. Выбирает тип оплаты "Оплата по QR-коду Альфабанк (СБП) ";

  4. Покупатель сканирует QRC расположенный в кассовой зоне в приложении;

  5. Касса регистрирует чек.

Примеры:



© 1994-2023, ООО «Кристалл Сервис Интеграция».
Все права защищены..

Политика обработки персональных данных