Работа с личным кабинетом
Сменить client-secret
Client-secret - авторизационный ключ сервиса. Он генерируется банком в момент заведения сервиса и передается оффлайн. После получения ключа измените client_secret в течение 40 дней методом /v1/change-client-secret или в личном кабинете SberBusinessAPI.
Изменить client-secret могут пользователи, обладающие следующими правами:
- электронная подпись с полномочиями единоличного исполнительного органа;
- единственная подпись;
- первая подпись;
- роль разработчика SberBusinessAPI.
Откройте параметры промышленного полигона В личном кабинете SberBusinessAPI перейдите на вкладку Параметры промышленного полигона.
Сгенерируйте новый client-secret В поле Client-secret нажмите кнопку Обновить. В открывшемся окне подтвердите генерацию client_secret по клику Подтвердить.
После генерации скопируйте client-secret, иначе он замаскируется и потребуется повторная генерация.
Сохраните копию, чтобы в дальнейшем ввести ее при отправке запроса.
Сгенерировать TLS-сертификат
TLS-сертификат, изданный банком, необходим для доступа к методам SberBusinessAPI.
В личном кабинете SberBusinessAPI перейдите на вкладку Сертификаты шифрования.
Нажмите кнопку Сгенерировать сертификат. Рядом с кнопкой отобразится количество доступных для генерации сертификатов.
В открывшемся окне укажите пароль доступа к сертификату согласно следующим требованиям к паролю:
- Содержит минимум 7 символов.
- Содержит цифры и буквы.
- Не содержит трех одинаковых символов подряд.
Нажмите кнопку Создать сертификат.
После успешной генерации TLS-сертификата в окне появится подтверждение и ссылка на скачивание файла сертификата. Нажмите Скачать файл сертификата.
Сгенерированные сертификаты появятся на вкладке Сертификаты шифрования. Нажмите Загрузить, чтобы скачать уже сгенерированные сертификаты. Чтобы скачать цепочку доверенных TLS-сертификатов, нажмите ссылку Загрузить в нижней части блока Сертификаты шифрования.
Установить TLS-сертификат
- Если у вас еще нет цепочки доверенных TLS-сертификатов, установите ее в каталог «Доверенные корневые центры сертификации».
- Установите TLS-сертификат в каталог «Личные» на том же компьютере.
Для работы на тестовом стенде установите цепочку тестовых TLS-сертификатов, для работы на промышленном стенде - цепочку промышленных TLS-сертификатов. В ОС Windows откройте файл контейнера сертификата в формате «.pfx».
Для OS Linux
В OS Windows файл контейнера сертификата имеет формат «.pfx». Для корректной работы в OS Linux конвертировать в более подходящий для системы формат («.pem») с помощью openssl.
Команды openssl для конвертации:
To convert a PFX file to a PEM file that contains both the certificate and private key, the following command needs to be used:
# openssl pkcs12 -in filename.pfx -out cert.pem -nodes
Conversion to separate PEM files
We can extract the private key form a PFX to a PEM file with this command:
# openssl pkcs12 -in filename.pfx -nocerts -out key.pem
Exporting the certificate only:
# openssl pkcs12 -in filename.pfx -clcerts -nokeys -out cert.pem
Проверить TLS-сертификат
Для проверки TLS-сертификата (тест/пром), необходимо перейти по соответствующим ссылкам:
Тестовый swagger: https://edupirfintech.sberbank.ru:9443/fintech/api/swagger-ui.html
Промышленный swagger: https://fintech.sberbank.ru:9443/fintech/api/swagger-ui.html
При переходе на ресурс запрашивается TLS сертификат. Если сертификат не установлен или установлен некорректно, то возникнет ошибка.
Отозвать TLS-сертификат
Чтобы отозвать TLS-сертификат, обратитесь к менеджеру или отправьте запрос на электронный ящик технической поддержки supportdbo2@sberbank.ru.
Получить/обновить/удалить AccessToken
Получить AccessToken
- В личном кабинете SberBusinessAPI перейдите на вкладку Ключи доступа.
- Нажмите кнопку Создать ключ
После создания скопируйте AccessToken, иначе он замаскируется и потребуется повторное создание.
Сохраните копию, например, в блокноте, чтобы в дальнейшем ввести ее при отправке запроса.
Раздел Мои ключи
Полученные AccessToken отображаются в разделе Мои ключи Обновить или удалить AccessToken можно с помощью соответствующих иконок напротив записи о ключе.
Раздел Другие ключи
В разделе Другие ключи отображаются:
- ФИО сотрудников вашей организации, которые выпустили AccessToken.
- Срок действия AccessToken.
Удаление AccessToken, выпущенных другими сотрудниками организации, доступно только для пользователя ЕИО.
Графики и отчеты
Для просмотра сведений о тарифах нажмите кнопку Показать все тарифы над графиком статистики запросов. Слева в колонке Стоимость (Количество запросов) отобразятся тарифные ставки.
Чтобы просмотреть сумму комиссии банка за конкретный месяц, наведите курсор на соответствующий столбец графика. Отобразится окно с информацией по выбранному месяцу.
Для того, чтобы скачать отчет по потреблению сервиса SberBusinessAPI нажмите кнопку PDF или XLS в верхней части графика статистики запросов.
Сформированный отчет будет содержать следующие данные:
- Дата формирования запросов;
- Наименование запросов;
- Количество выполненных банком запросов;
- Расчетный период;
- Для каждого расчетного месяца указаны: количество запросов, сумма комиссии банка;
- Реквизиты банка для оплаты вознаграждения банка.
Вы также можете настроить оповещения об использовании SberBusinessAPI. Для этого выберите необходимые уведомления и укажите желаемое количество запросов. После этого нажмите Сохранить.
При достижении указанного количества запросов для уведомления при определенном значении запросов придет письмо на электронную почту.
Отключить сервис
Отключение сервиса доступно при наличии подключенных незаблокированных сервисов.
Откройте Личный кабинет SberBusinessAPI В меню слева выберите Все продукты и услуги. На открывшейся странице нажмите кнопку Подключенные продукты. Из списка подключенных продуктов выберите SberBusinessAPI.
Отключите сервис В правом верхнем углу личного кабинета нажмите кнопку Отключить сервис.
Заполните заявление В заявлении укажите контактные данные представителя и дату, с которой необходимо отключить SberBusinessAPI. Нажмите кнопку Создать.
Отправьте заявление в банк Подпишите документ с помощью СМС-кода или токена и отправьте его в банк.
После исполнения заявления будут отключены все сервисы, подключенные через СберБизнес и офисы банка.
Отследить статус заявления вы можете в разделе Моя организация > Заявления. До завершения отключения в личном кабинете будет отображена информационное сообщение о дате отключения.
Назначить сотруднику роль разработчика SberBusinessAPI
Роль разработчика SberBusinessAPI предназначена сотруднику для доступа в личный кабинет SberBusinessAPI. У сотрудника не будет доступа к документам и разделам СберБизнес.
Подробную информацию о добавлении сотрудника и назначении ролей вы найдете в статье на портале Справочного центра для бизнеса.
- Выберите роль При заполнении карточки Новый пользователь нажмите кнопку Выбрать роль.
- Назначьте роль В строке Полномочия найдите роль Разработчик SberBusinessAPI. Нажмите кнопку Назначить.
Внесите данные о сотруднике Заполните поля: сотрудник, логин, счета и телефон. Нажмите Создать.
Отправьте заявление в банк Подпишите документ с помощью СМС-кода или токена и отправьте его в банк. Отследить статус заявления вы можете в разделе Моя организация > Заявления.