Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTZ-1838

...

Статус
colourBlue
title10.3.17.0

Оглавление

Описание

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

Настройка

Сервер

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

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

Image Modified

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

Image Modified

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

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

Сертификат

.crt

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

  • В случаях, когда у клиента tcnm ключ клиента и ключ банка необходимо их прописать в соответствующие поля.
  • В случае, когда у клиента нет своего ключа, но имеется только ключ банка необходимо продублировать этот ключ и в поле ключа клиента и в поле ключа банка/
  • Какие ключи будут у клиента зависит от договоренности между клиентом и Альфабанком.
Сертификат в формате base64
Сертификат X.509 банка в base64Сертификат для подписи запроса при подключении к TLS шлюзу.Пример файла сертификата cert.crt
Закрытый RSA ключ
.key
банка в
формате
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

Image RemovedImage Added

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

Image Modified

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

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

Image Modified

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

Image Modified

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

Image Modified

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

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

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

Image Modified

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

Image Modified

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

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

Image Modified

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

Image Modified

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

Image Modified

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

...

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

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

Image Modified

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

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

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

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

Image Modified

Касса

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

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

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

Image Modified

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

...

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

Информация

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

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

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

...

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

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

Image Modified

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

Image Modified

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

Image Modified

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

Image Modified

SetTouch

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

Image Modified

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

Image Modified

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

Image Modified

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

Image Modified

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

Image Modified

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

Image Modified

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

...

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

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

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

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

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

...