Инструкция по подключению сервиса "Безопасные сделки" на промышленном стенде
📋 Оглавление
- Пререквизиты
- Этап 1: Работа со Сбер API
- Этап 2: Открытие номинального счета
- Этап 3: Выпуск УКЭП и регистрация
- Завершение подключения
Пререквизиты
Перед началом работы на промышленном стенде должно быть выполнено обязательное условие:
⚠️ Проведено демо реализации совместно с командой продукта.
Этап 1: Работа со Сбер API
Шаг 1.1: Разблокировка промышленного стенда
Активируйте промышленный стенд в личном кабинете СберБизнес по инструкции в разделе "Активировать сервис".
Результат: Промышленный стенд разблокирован и готов к эксплуатации.
Шаг 1.2: Настройка TLS-сертификатов
Установите и проверьте сертификаты для промышленного стенда по инструкции.
Результат: TLS-сертификаты для промышленного стенда установлены и проверены.
Шаг 1.3: Получение в личном кабинете СберБизнес токенов доступа
Получите в личном кабинете СберБизнес access token и refresh token по инструкции (раздел "Получить/обновить/удалить пару access_token и refresh_token").
🔍 Важно
Если во вкладке Ключи доступа отсутствует кнопка Создать ключ, необходимо обратиться в поддержку: supportdbo2@sberbank.ru.
Результат: Получены токены доступа для промышленного стенда (для разового использования).
Шаг 1.4: Реализация автоматического обновления токенов доступа на промышленном стенде
Реализуйте автоматическое обновление access token и refresh token на промышленном стенде по инструкции.
Результат: Реализовано автоматическое обновление токенов доступа на промышленном стенде (для постоянного использования).
Этап 2: Открытие номинального счета
Шаг 2.1: Открытие номинального счета
Подать заявку на открытие номинального счета.
ℹ️ Примечание
Данные о номинальном счете будут автоматически переданы в систему продукта после открытия.
Результат: Номинальный счет открыт для учета средств нескольких бенефициаров.
3. Выпуск УКЭП и регистрация
Шаг 3.1: Получение электронной подписи для работы с промышленным стендом
⚠️ Важное условие: для отправки любого POST-запроса в API «Безопасные сделки» требуется корректная электронная подпись, сформированная согласно Правилам наложения подписи. Запросы без валидной ЭП обрабатываться не будут.
На промышленном стенде поддерживаются следующие типы сертификатов:
-
УКЭП — сертификат любого аккредитованного удостоверяющего центра (УЦ);
-
УНЭП — сертификат, выпущенный УЦ Сбербанка. Документация по выпуску УНЭП: под сотрудником (чей access token используется), под ЕИО (на разных сотрудников).
На этапе проектирования решения обратите внимание на признак экспортируемости закрытого ключа ЭП.
В зависимости от политики УЦ сертификат может быть выдан с неизвлекаемым (неэкспортируемым) ключом. В этом случае подписание возможно только через криптопровайдер на том устройстве, где был установлен сертификат (перенос ключа на другую машину запрещен). Учитывайте это при выборе архитектуры (например, при необходимости переноса подписанта между рабочими станциями).
⚠️ Обратите внимание: выпуск сертификата не входит в зону ответственности сервиса «Безопасные сделки». Все вопросы по получению, продлению или настройке сертификата решаются напрямую с вашим удостоверяющим центром.
Результат: Получен УКЭП или УНЭП для подписания POST-запросов на промышленном стенде.
Шаг 3.2: Добавление в белые списки на промышленном стенде
- Передайте в адрес поддержки продукта (prom_teh_safe_pay@sberbank.ru) строку подписи над произвольным контентом.
- Получите в ответ идентификатор сертификата.
- Обратитесь к территориальному менеджеру для заключения доп. соглашения, указав в нем полученный идентификатор сертификата.
С правилами наложения подписи можно ознакомиться на странице
Результат: Заключено дополнительное соглашение, площадка добавлена в белые списки на промышленном стенде.
Шаг 3.3: Регистрация площадки на промышленном стенде
Зарегистрируйте площадку на промышленном стенде с помощью вызова метода POST/v1/nominal-account/signup (для схемы Бенефициар-заказчик) или POST/v1/secure-deals/signup (для схемы Бенефициар-исполнитель).
Не забудьте подписать запрос в соответствии с правилами наложения подписи.
Завершение подключения
🎉 Поздравляем! Ваше приложение подключено к промышленному стенду и готово к работе!