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

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

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

февр. 13, 2025

https://crystals.atlassian.net/browse/SRTZ-1838

https://crystals.atlassian.net/browse/CR-7448

10.3.17.0

Описание

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

Настройка

Сервер

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

.

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

.

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

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

.

Параметр

Описание

Пример значения

Параметр

Описание

Пример значения

Закрытый RSA ключ клиента в base64

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

  • В случаях, когда у клиента есть ключ клиента и ключ банка необходимо их прописать в соответствующие поля.

  • В случае, когда у клиента нет своего ключа, но имеется только ключ банка необходимо продублировать этот ключ и в поле ключа клиента и в поле ключа банка.

  • Какие ключи будут у клиента зависит от договоренности между клиентом и Альфабанком.

Сертификат в формате base64

Сертификат X.509 банка в base64

Сертификат для подписи запроса при подключении к TLS шлюзу.

Пример файла сертификата 

Закрытый RSA ключ банка в base64

Закрытый ключ для валидации подписи сертификата.

Пример файла закрытого ключа 

Имя сертификата на стороне Альфабанка

Наименование сертификата, выдаваемое Альфабанком для каждого сертификата.

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"/>