Решения

Подключение SberPay QR/Плати QR

15 мая 2024
20 мин.

Нет времени читать?

Отправим материал вам на почту

статья в разработке

Содержание

  1. Введение
  2. Настройка на стороне банка
    1. Регистрация на портале Sber API Registry
    2. Создание приложения и выпуск сертификата
    3. Подписка приложения на продукт SberPay QR
    4. Сбор параметров для дальнейшей настройки
    5. Подключение уведомлений
  3. Настройка интеграции в программе
    1. Добавление интеграции
    2. Общие настройки
    3. Дополнительные настройки
       1) Переход к форме настроек
       2) Добавление новой записи
       3) Загрузка сертификатов
       4) Настройка типа оплаты
       5) Настройка уведомлений о смене статусов

 

Функционал доступен начиная с релиза 2.7.2.

Введение

В текущей статье представлено описание подключения и настройки интеграции для работы с API СБП Сбербанка.

Описание сервиса СБП, процесса приема оплаты в программе и предварительных настроек см. в статье Работа с СБП.

Настройка на стороне банка

Подробную инструкцию см. на сайте банка: https://api.developer.sber.ru/product/PlatiQR/doc/v1/QR_API_doc3.

1. Регистрация на портале Sber API Registry

Требуется пройти несколько шагов:

  1. Обратиться к персональному менеджеру и подключить услугу “SberPay QR”.
  2. Зарегистрироваться на портале https://api.developer.sber.ru/, указать email, придумать пароль,
  3. Отправить анкету в техподдержку с указанного при регистрации email на адрес support@ecom.sberbank.ru c пометкой “продукт: QR.API, регистрация. Организации, API V3.0.0”.
    Файл анкеты: Anketa QR.API (SberPay QR).xlsx.
  4. Дождаться завершения регистрации: техподдержка банка должна прислать на ваш email присвоенный код MemberID – он потребуется для дальнейшей настройки. В течение 3 дней будет создана Организация.

Подробнее см. в полной инструкции на сайте.

2. Создание приложения и выпуск сертификата

Для работы с QR.API необходимо авторизоваться на портале, переключиться в личном кабинете в режим организации, кликнуть на кнопку "Создать новое приложение":

СБП Сбера - Авторизация

Далее нужно заполнить форму:

СБП Сбера - Новое приложение

Важно! После создания приложения откроется окно с clientID и clientSecret. Пароль clientSecret будет показан 1 раз! Пароль необходимо скопировать и сохранить себе отдельно для использования в дальнейшей настройке:

СБП Сбера - Скопировать пароль

Важно! При регистрации сертификата будет доступен для скачивания архив в формате .p12 – необходимо его скачать: 

СБП Сбера - Выпуск сертификата

Далее необходимо из загруженного сертификата .р12 получить приватный ключ и клиентский сертификат. Это можно сделать с помощью утилиты OpenSSL:

openssl pkcs12 -in <имя вашего файла>.p12 -nodes -nocerts -out private.key

openssl pkcs12 -in <имя вашего файла>.p12 -clcerts -nokeys -out client_cert.crt

потребуется ввод пароля от сертификата

В случае возникновения сложностей, обратитесь в техподдержку 5SYSTEMS.

Полученные приватный ключ и клиентский сертификат необходимо будет загрузить в программу при дальнейшей настройке – см. ниже.

3. Подписка приложения на продукт SberPay QR

Созданное приложение следует подписать на продукт "SberPay QR/Плати QR":

СБП Сбера - Подключение продукта

4. Сбор параметров для дальнейшей настройки

Для выполнения дальнейшей настройки подключения сервиса в программе будут нужны следующие параметры:

MemberID – идентификатор клиента, полученный при регистрации организации на портале (см. выше).

IdQR – уникальный идентификатор устройства в системе "Плати QR". Параметр можно узнать в личном кабинете организации на сайте Сбера в разделе Эквайринг → Оборудование, он отображается после подключения услуги:

СБП Сбера - ID обрудования

clientID – доступен для копирования на странице "Ключи" в приложении.
и
clientSecret
– пароль, который нужно было сохранить в процессе выпуска сертификата – см. выше. Если пароль утерян, можно его сбросить и получить новый.

СБП Сбера - Ключи

Клиентский сертификат и приватный ключ (личный ключ) – 2 файла, полученные из загруженного сертификата .р12 (см. выше).

5. Подключение уведомлений

Для подключения уведомлений об оплате необходимо отправить с указанного при регистрации email в техподдержку Сбера на адрес support@ecom.sberbank.ru запрос следующего содержания:

“Прошу подключить сервис "SberPay QR/Плати QR - Уведомления об оплате" к нашей организации (ООО "<наименование организации>", ИНН ХХХХХХХХХХ)

Endpoint для проксирования вызова:
https://api.5systems.ru/payment/v1/sber/notify”.

Настройка интеграции в программе

1. Добавление интеграции

Описание общих настроек для платежных систем всех банков см. в статье “Работа с СБП”.

Для Сбербанка при добавлении новой интеграции следует ввести следующие реквизиты:

Интеграция с СБП - Создание интеграции - Сбер

   ●  Наименование – “Плати QR Sber”; 
   ●  Вид интеграции – “Сбербанк”;
   ●  Обработчик подключения – “Плати QR Sber”.

2. Общие настройки

Затем необходимо перейти на вкладку “Параметры сервиса” и заполнить общие параметры согласно инструкции в статье “Работа с СБП”.

3. Дополнительные настройки

1) Переход к форме настроек

Далее необходимо перейти на вкладку “Тест подключения” в меню “Методы интеграции → Настройки”:

Интеграция с СБП - Настройки дополнительные

Данная форма настроек предназначена для добавления и редактирования информации в списке интеграций "Плати QR Sber":

Интеграция с СБП - Настройки дополнительные
Столбцы таблицы:

   ●  Идентификатор – идентификатор интеграции с “Плати QR Sber”;
   ●  Заголовок – название организации;
   ●  Описание – описание аккаунта;
   ●  ID пользователя – MemberID, идентификатор клиента, полученный при регистрации организации на портале сервиса (см. выше);
   ●  ID QR – уникальный идентификатор устройства в системе "Плати QR" (см. выше).

2) Добавление новой записи

Для добавления новой записи настроек следует нажать кнопку Добавить новую запись”, заполнить параметры и нажать кнопку “Создать”:

Интеграция с СБП - Настройки дополнительные - Добавление
Параметры MemberID, IdQR, ClientId и ClientSecret следует получить при настройке сервиса на стороне банка – см. выше.

Из данной формы также можно перейти к загрузке сертификатов – см. далее. 

Также есть возможность:

   ●  Изменить текущую запись – изменить регистрационные данные при необходимости;
   ●  Удалить выбранную запись.

Для осуществления указанных действий следует выделить галочкой выбранную запись и нажать соответствующую кнопку на верхней панели формы.

3) Загрузка сертификатов

Для интеграции с платежной системой Сбербанка необходимо загрузить файлы сертификата и личного ключа, полученные из скачанного в ЛК файла сертификата .p12 на этапе настройки сервиса на стороне банка – см. выше

Интеграция с СБП - Загрузка сертификатов

Также требуется ввести срок действия сертификатов – он отображается на странице “Ключи” в Приложении (см. выше).

После загрузки сертификатов форма должна отображаться следующим образом:

Интеграция с СБП - Загрузка сертификатов - Загружены

4) Настройка типа оплаты

Далее следует настроить тип оплаты для пробития чеков в программе – см. в статье “Работа с СБП”. Для Сбербанка должен быть настроен тип оплаты “СБП Сбербанк”. 

После настройки типа оплаты следует сделать тест подключения – см. в статье “Работа с СБП”.

5) Настройка уведомлений о смене статусов

Необходимо активировать и настроить уведомления о смене статусов платежей – см. в статье “Работа с СБП”.

кнопка вверх

  • Необязательно:

  • Уточните, пожалуйста, почему: