Публичное пространство
Оплата 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, которую банк отображает в выписке, передаваемой ритейлеру. Допустимые значения:
| Оплата по СБП |
Срок действия 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, ООО «Кристалл Сервис Интеграция».
Все права защищены..