Подключение SberPay QR/Плати QR
Нет времени читать?
статья в разработке
Содержание
Функционал доступен начиная с релиза 2.7.2.
Введение
В текущей статье представлено описание подключения и настройки интеграции для работы с API СБП Сбербанка.
Описание сервиса СБП, процесса приема оплаты в программе и предварительных настроек см. в статье Работа с СБП.
Настройка на стороне банка
Подробную инструкцию см. на сайте банка: https://api.developer.sber.ru/product/PlatiQR/doc/v1/QR_API_doc3.
1. Регистрация на портале Sber API Registry
Требуется пройти несколько шагов:
- Обратиться к персональному менеджеру и подключить услугу “SberPay QR”.
- Зарегистрироваться на портале https://api.developer.sber.ru/, указать email, придумать пароль,
- Отправить анкету в техподдержку с указанного при регистрации email на адрес support@ecom.sberbank.ru c пометкой “продукт: QR.API, регистрация. Организации, API V3.0.0”.
Файл анкеты: Anketa QR.API (SberPay QR).xlsx. - Дождаться завершения регистрации: техподдержка банка должна прислать на ваш 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". Параметр можно узнать в личном кабинете организации на сайте Сбера в разделе Эквайринг → Оборудование, он отображается после подключения услуги:
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) Настройка уведомлений о смене статусов
Необходимо активировать и настроить уведомления о смене статусов платежей – см. в статье “Работа с СБП”.
-
Необязательно:
-
Уточните, пожалуйста, почему: