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

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

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

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

10.3.18.0

В текущей версии (10.3.18.0) не реализовано оформление возвратов.

Описание

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

Настройка

Сервер

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

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

3. Кликните по процессингу Банк ВТБ (СБП).

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

ПараметрОписаниеПример значения
Сертификат .crt в формате PKCS12 (base64)Сертификат для подключения, сконвертированный в формат base64.crystals_base64_cert.txt
Ключевая фраза сертификатаПароль сертификата, может отсутствовать.123456
Идентификатор зарегистрированного партнёра в СБПИдентификационный номер, предоставляемый банком для магазина в системе СБП.MA0000100223
Идентификатор агента в СБПИдентификационный номер агента в СБП, предоставляемый банком.A00000000010
Идентификатор банка-участника СБПИдентификационный номер банка-участника100000000005
Идентификатор зарегистрированного ЮЛ или ИП в СБПИдентификационный номер, предоставляемый банком для юридического лица или индивидуального предпринимателя в системе СБП.LA0000015221
Счет юридического лицаСчет юридического лица магазина на который оформлен банковский процессинг.40702810013646921308
Назначение платежа (отображается в выписке)

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

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

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

Конвертация файла сертификата

Пример файла сертификата: crystals.pfx

1. Скопируйте полученный от банка файл сертификата в папку, например /home/temp/

2. Перейдите в папку с сертификатом:

cd /home/temp/

3. Выполните команду для конвертации сертификата в формат .pem, подставив имя файла:

openssl pkcs12 -in crystals.pfx -out crystals.pem

4. Введите пароль, выданный вместе с сертификатом → нажмите Enter.

Внимание! Процесс ввода пароля не отображается!

5. Введите ключевую фразу → подтвердите ключевую фразу → нажмите Enter.

6. Введите команду для конвертации сертификата в формат .p12

openssl pkcs12 -export -in crystals.pem -out crystals.p12 -name "crystals"

7. Введите ключевую фразу → введите пароль → подтвердите пароль → нажмите Enter.

8. Выполните следующие команды для конвертации сертификата в формат base64, а также чтобы убрать переносы строк в файле сертификата → скопируйте содержимое файла crystals_base64_cert.txt в поле Сертификат .crt в формате PKCS12 (base64)

base64 crystals.p12 > crystals_temp.txt
tr -d '\n' < crystals_temp.txt > crystals_base64_cert.txt

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

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

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

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

1. Откройте на редактирование файл на сервере ../standalone/configuration/modules/external-systems-manager/banks.xml.

2. Добавьте следующие параметры:

	<bank name="vtb_sbp">
        <locale-info value="Банк ВТБ (СБП)" language="ru_RU" />
        <locale-info value="Банк ВТБ (СБП)" language="ru" />
        <locale-info value="VTB Bank (SBP)" language="en_UK" />
        <locale-info value="VTB Bank (SBP)" language="en" />
    </bank>

3. Обновите страницу визуализации сервера.

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

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

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

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

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

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

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

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

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

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

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

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

Касса

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

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

2. Для проведения тестовых оплат на стенде добавьте строку с параметром <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. Нажмите ОТМЕНА → выберите Сохранение.

7. Выберите Перезагрузить.

SetTouch

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

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

3. Выберите Банк ВТБ (СБП).

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

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

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

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

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

Примеры:

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

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