Подключение
Портал разработчика Sber API Registry
Ссылка на портал: https://api.developer.sber.ru/
На текущий момент платформа QR.API на портале разработчика имеет следующие настройки видимости:
пре-логин зона - доступно всем,
возможность подписки – доступно всем зарегистрированным пользователям ФЛ с привязкой к ЮЛ (пост-логин зона).
Партнеры имеют возможность регистрации на портале разработчика как ФЛ. Затем через менеджеров поддержки сервиса необходимо зарегистрировать организацию - ЮЛ и связать зарегистрированное ФЛ с организацией .
Далее для организации необходимо создать приложение организации и подписать его на платформу QR.API с выбранными тарифами. Во все тарифы включен API авторизации (token 3.0.0)
Для корректной и безопасной работы со SberAPI следует использовать рекомендованный список SSL-шифров:
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256;
Этап 1. Подключение организации к порталу разработчика Sber API
Регистрация на портале (физ лица)
Регистрация на портале состоит из нескольких шагов:
онлайн регистрации физ. лица,
офлайн регистрации юр. лица (организации) - настройка производится после заключения договора по запросу в тех. поддержку
онлайн прикрепления персонального профиля физ. лица к организации (настройка в ЛК на портале).
- Перейдите на страницу портала разработчика https://api.developer.sber.ru/, нажмите кнопку «Зарегистрироваться»
- На открывшейся форме нужно пройти стандартную регистрацию с введением почты или войти по SberID/Сбербизнес ID. Для первичной регистрации физ. лица нажмите «зарегистрироваться».
Если воспользоваться стандартной регистрацией с введением почты, то аккаунт будет создан на ФЛ и далее потребуются дополнительные действия для регистрации Организации.
Если войти по СберБизнесID с использованием СбербанкБизнесОнлайн, Организация будет создана автоматически, но для завершения настройки подключения требуется заключить договор обратившись к менеджеру Сбербанка. Инструкция по входу через СберБизнесID: https://api.developer.sber.ru/how-to-use/sberbusiness_id
При регистрации физ лица на указанный адрес электронной почты поступит письмо для подтверждения:
После подтверждения учетной записи по ссылке вы вернетесь на главную страницу портала. Для входа в учетную запись (в личный кабинет) нажмите на кнопку «войти» в правом верхнем углу.
После входа на портал под своей учетной записью отредактируйте свой профиль (в правом верхнем углу) – укажите ФИО и номер телефона. Здесь же можно сменить пароль.
Регистрация на портале (юр лица)
Для создания Организации необходимо направить заполненную Анкету (документ размещен в следующем абзаце) на почту support@ecom.sberbank.ru c отметкой «продукт: QR.API, регистрация. Организации, API V3.0.0». В ответ поступит информация с присвоенным номером MemberID и в течение 3 дней будет создана Организация.
Если организация была создана при входе на портал под СберБизнесID, для дальнейшей настройки вам так же необходимо заполнить анкету и обратится к менеджеру Сбербанка для заключения договора и получить MemberID организации.
Анкета для подключения к сервису "SberPay QR/Плати QR": Anketa QR.API (SberPay QR).xlsx
Анкета для подключения к сервису "СБП QR": Anketa QR.API (QR SBP).xlsx
После регистрации организации и присвоения MemberId необходимо зайти в ЛК, затем в раздел «мой профиль» и переключиться в режим организации.
Чтобы при входе в ЛК попадать в режим организации отметьте чек-бокс «установить по умолчанию» после включения режима организации:
После отметки чекбокса будет запрошено подтверждение:
Для работы с QR.API необходимо создать приложение и подписать его на соответствующий сервис. Одно приложение может быть подписано на несколько сервисов.
Этап 2. Создание приложения и выпуск сертификата
Для создания приложения необходимо войти в ЛК в режиме организации и нажать «создать новое приложение»:
Откроется форма создания приложения, в которой необходимо указать произвольное название и описание. Поле OAuth Redirect URI не используется и не требует заполнения.
Одновременно с созданием приложения необходимо выпустить сертификат. Сертификат выпускается на почту личного аккаунта. Придумайте пароль состоящий из латинских букв и цифр длиной не менее 8 символов. Работа с сертификатами описана по ссылке: https://api.developer.sber.ru/how-to-use/create_certificate
Оповещений на e-mail о истечении срока действия сертификата не предусмотрено. Новый сертификат можно выпустить за 60 дней до окончания срока действия текущего сертификата. После заполнения описания приложения и пароля сертификата нажмите кнопку «Создать»
ВАЖНО! После создания приложения откроется окно с ClientID и ClientSecret. ClientSecret будет показан 1 раз, его необходимо скопировать и сохранить себе отдельно для использования в дальнейшем при интеграции. Сертификат необходимо установить на устройство, с которого будет производиться подключение к API. Для расшифровки контейнера необходимо использовать введенный вами пароль на этапе заказа сертификата в Личном кабинете.
Срок действия сертификата один год (контроль и перевыпуск сертификата осуществляется на стороне партнера).
Переходим «в приложение»
Работа с приложением
Настроенные приложения представлены плитками на главном экране ЛК при работе в режиме организации. Для работы с приложением нажмите на его плитку. Внутри приложения доступны четыре раздела:
Подписки
Ключи
Сертификаты
Настройки
Этап 3. Подписка приложения на продукт
- Войдите в каталог сервисов, найдите продукт «Плати QR». На странице выбранного продукта дано описание доступных вариантов (API и тарифов) подключения. Для удобства можно воспользоваться поиском по ключевым словам.
Важно: если у вас зарегистрирована организация, но нет договора, подключение сервиса будет невозможно. Для заключения договора необходимо обратится к менеджеру Сбербанка.
2. Выберете тариф:
QR-код Продавца SberPay QR и СБП - позволяет работать только с QR-кодом продавца
QR-код Покупателя SberPay QR - позволяет работать только с QR-кодом покупателя
(
каждому тарифу соответствует АПИ:
- После ознакомления с информацией нажмите кнопку «Подключить»
* список доступных тарифов может меняться
Для работы с QR-кодом Продавца требуется выбрать тариф QR-код продавца SberPay QR и СБП После выбора тарифа нажмите кнопку «Далее» Если у партнера тарифы не доступны, так как необходима регистрация договора, то необходимо написать об этом на почту support@ecom.sberbank.ru c пометкой «продукт: QR.API, создание договора». Уточнить какой тариф/сценарий подключается и приложить Анкету (предоставленную менеджером Сбербанка).
4. На следующем шаге в ниспадающем списке укажите название приложения (созданного клиентом), например, «Плати QR v3» и нажмите кнопку "Далее"
5. Проверьте выбранные настройки и завершите процесс нажатием кнопки «Подключить». Подписка завершена.
В разделе приложений ЛК добавится приложение «Плати QR» с настроенной подпиской:
В разделах «ключи» и «сертификаты» доступна информация по ClientID и ClientSecret и по статусу сертификата. По клику на плитку подписки открывается информация:
Подписка на сервис уведомлений
Данный раздел предназначен для партнеров подключающихся к тарифу QR-код продавца SberPay QR и СБП
В дополнение к тарифу QR-код продавца SberPay QR и СБП рекомендуется подключить сервис "Уведомлений об оплате". Сервис является входящим для партнеров и поэтому не требует настройки подписки в личном кабинете. В анкете заполняемой при регистрации юр. лица вам необходимо указать эндпойнт для приема входящего вызова и реализовать на своей стороне поддержку сервиса Notify описанного в спецификации. Подключение сервиса уведомлений позволит вам отказаться от многократных вызовов запроса статуса заказа и получать уведомление по факту его оплаты.
Подключение к сервису уведомлений никак не ограничивает торговою точку в использовании сервиса запроса статуса заказа.