Подключение и использование УКЭП
Обновлено 7 сентября 2026
На данный момент подписание УКЭП доступно только для рублевых платежных поручений и переводов СБП B2C.
Подключить
Подключить возможность подписания с помощью УКЭП можно в СберБизнес или методами API.
В СберБизнес
Чтобы настроить полномочие подписания УКЭП в кабинете СберБизнес, необходимо выполнить настройку под владельцем подписи.
1. Откройте СберБизнес и перейдите в настройки СберБизнес ID.
2. Найдите пункт "Подпись УКЭП юрлица" и нажмите редактировать.
3. В появившемся окне нажмите "Подключить".
Методами API
Для подключение УКЭП методами API, необходимо использовать методы:
-
POST /v1/crypto/ukep-ul/activate - Подключение УКЭП ЮЛ для учетной записи
-
POST /v1/crypto/ukep-ul/deactivate - Отключение УКЭП ЮЛ для учетной записи
Подписание УКЭП
Работа с подписью УКЭП ЮЛ в РПП
| Шаг | Действие | Дополнительная информация |
|---|---|---|
| 1 | Получите certificateUuid: вызовите метод получения криптоинформации и из массива certificateInfos для typeName = UKEP_UL возьмите значение uuid | GET /v1/crypto GET /v1/crypto/eio |
| 2 | Сформируйте дайджест для РПП | Документация по РПП |
| 3 | Подпишите дайджест УКЭП ЮЛ | Используйте ваше СКЗИ |
| 4 | Отправьте запрос на создание РПП в API /v1/payments с заголовком Authorization: access_token пользователя, на имя которого выпущен сертификат. В теле запроса заполните: * certificateUuid (из шага 1) * base64Encoded (открепленная подпись под дайджестом в Base64 из шага 3) * signType = "UKEP_UL" | Важно: * Без certificateUuid запрос будет отклонен * В digestSignatures может быть только одна подпись * При несоответствии подписи и токена платеж создастся как Черновик, позже будет отклонен со статусом INVALIDEDS |