История обновлений
В этом разделе вы найдете историю обновлений и изменений документации.
Сентябрь
11.09.2025
-
Добавлены ссылки на API эндпоинты в бизнес-сценарий.
-
Реализовали новый сервис "СБП B2B оплата" для создания ссылки на перевод.
-
Обновили бизнес описание сервиса "Безопасные сделки". Реализовали возможность выплат физическим лицам с номинального счета по СБП.
-
Реализовали механизм уплаты налогов в рамках подтверждения смарт-контракта.
-
Опубликована новая страница с описанием сервиса для выставления счетов контрагентам через API. Сервис находится на этапе beta-тестирования и доступен для ограниченного круга партнеров по предварительной заявке. Функционал позволяет создавать счета и получать ссылки для их оплаты без интеграции с OAuth. Для получения доступа необходимо оставить заявку через форму на странице документации.
-
Реализованы методы v2 для работы с электронной подписью. Функционал позволяет перевыпустить УНЭП без посещения банка.
Информируем, что 30 ноября 2025 года в канале Sber API будет прекращена поддержка и полностью отключены методы версии v1 для работы с электронной подписью.
Список всех затронутых методов:
Рекомендуем заранее провести внедрение и тестирование с API v2.
Август
18.08.2025
-
Добавили информацию о валюте, в которой можно разместить депозиты и неснижаемый остаток.
-
Уточнили описание параметров account и payDocs при создании зарплатной ведомости с резервированием и без.
-
Уточнили порядок атрибутов TLS сертификата.
-
Обновили раздел FAQ.
04.08.2025
- Обновили формат описания для следующих ресурсов:
-
Описали альтернативный сценарий подписания зарплатного реестра для платформ.
-
Добавили информацию о необходимости установки сертификатов Минцифры для тестового стенда.
-
Во все запросы справочника API добавлены тестовые и промышленные url.
-
Описали сценарий создания платежного поручения за счет кредитных средств.
Важное обновление: Изменения в работе API /client-info для повышения безопасности данных
В рамках постоянного улучшения безопасности и соответствия стандартам, мы усиливаем механизмы проверки передаваемых данных в API /client-info.
Что изменится?
С 16 августа 2025 года ответ на запрос /client-info будет формироваться строго в соответствии с scope, указанным в авторизации пользователя. Это означает, что партнеры будут получать только те данные, доступ к которым был явно предоставлен клиентом.
Что проверить?
1. Убедитесь, что в scope вашего приложения добавлены все необходимые claim для запрашиваемых данных.
2. Если используется v2 авторизации, проверьте, что все claim передаются в параметре scope при формировании ссылки /ic/sso/api/v2/oauth/authorize (документация).
3. Для интеграций с API-наборами "Платформы", "Холдинги", "Корпоративные подписки" и "Кредит в корзине" помните: при изменении scope клиентам потребуется переподписать оферту.
Рекомендации
- Проверьте логику работы ваших сервисов: если какие-то данные станут недоступны, запросите у клиентов дополнительные разрешения через обновленный scope.
- Если вам нужна помощь с настройкой scope, обратитесь в поддержку: supportdbo2@sberbank.ru.
Июль
21.07.2025
-
Разместили информацию о тестовом стенде на отдельной странице.
-
Уточнили параметры urgencyCode и vat.type в платежных поручениях, добавили описание параметров.
-
Обновили описание сервиса "Моментальные платежи". Описали сценарий B2C платежей.
-
Обновили формат описания для следующих ресурсов:
- /files
- Добавили информацию о кодировании ссылки авторизации и пример в urlencode.
03.07.2025
-
Разработан SDK для упрощения интеграции учетных систем с Sber API.
-
В заголовке ответов на запросы появился новый параметр X-Rq-Uid. В случае обращении на поддержку Sber API данный параметр позволяет оперативно найти логи на стороне банка. Рекомендуется предусмотреть логирование данного параметра.
-
В сервисе «Безопасные сделки» появился новый метод для запроса списка событий по возврату невыясненных сумм на номинальный счет по факту отказа в зачислении в сторонних банках.
-
Реализовали новый сервис для дистанционного выпуска нового сертификата электронной подписи.
-
Появилась возможность запрашивать выписки за определенный период не только по расчетным счетам, но и по транзитным.
-
Новый сервис «Неснижаемый остаток» позволяет корпоративным клиентам напрямую через API-интеграцию управлять размещением д енежных средств в виде неснижаемого остатка на расчетном счете.
-
В связи с реорганизацией территориальных учреждений Банка России с 15 июля 2025 года меняются номера БИК и корреспондентского счета для проведения расчетов и платежей.
Апрель
25.04.2025
- Добавили спецификацию на новые методы для работы с депозитами (
/placement/deposit
). - В новом разделе "Экосистема Сбера" разместили описание и спецификацию методов для работы сервисом SberCrossOrder.
18.04.2025
- Переложили описание кодов статусов зарплатной ведомости (
GET /fintech/api/v1/payrolls/{externalId}/state
) на страницу с обновленным форматом.
11.04.2025
-
Обновили атрибутный состав запроса на TLS сертификат,
-
Изменили алгоритм проверки TLS-сертификата. Теперь после загрузки сертификата через supportdbo2@sberbank.ru или выпуска в личном кабинете Sber API сертификат автоматически распространяется на все сервисы Sber API организации. Загрузить сертификат в сервис, принадлежащий другой организации, больше нельзя,
-
Изменили спецификацию сервиса Безопасные сделки. Добавили таблицу ошибок и статусные модели, изменили адрес страницы со спецификацией основного API,
-
Теперь создавать и обновлять токен доступа можно прямо из личного кабинета. Описали это подробно в обновленном разделе,
-
Теперь все стайлгайды, нужные вашей веб-разработчикам, находятся на одной странице.
Март
31.03.2025
- Обновили инструкции по формированию TLS-сертификатов для OC Windows, MacOS, Linux;
- Для /payments:
- изменили схему не успешных ответов (в ней появилось поле
internalErrorCode
, значение которого можно указывать при обращении в поддержку), - вернули описание статусов РПП,
- уточнили значения скоупов;
- Вернули описание ошибок в /statements;
- Обновили формат описания для следующих ресурсов:
24.03.2025
-
Уточнили регулярное выражение для полей
client_secret
,new_client_secret
и тип метода для обновления Client Secret, -
Добавили пояснение о том, какой набор атрибутов (клэймов) возвращается в ответе на запрос для получения информации о компании,
-
На страницу описания запроса данных по ранее созданной зарплатной ведо мости добавили таблицы с описанием статусов чеков самозанятых для ФНС
receiptResult
иreceiptStatus
, -
Добавили ошибку 429 (
Too Many Requests
) в описания ответов по следующим методам:
-
POST
/v1/payments
-
POST
/v1/payments/from-invoice
-
POST
/v1/payments/from-invoice-any
-
POST
/v1/payments/from-invoice-budget
-
GET
/v1/payments/{externalId}/state
-
GET
/v1/payments/{externalId}
-
POST
/v1/pay-doc-cur
-
GET
/v1/pay-doc-cur/{externalId}/state
-
GET
/v1/pay-doc-cur/{externalId}
-
GET
/v1/crypto
-
POST
/v1/crypto/cert-requests
-
GET
/v1/crypto/cert-requests/{externalId}/state
-
POST
/v1/crypto/cert-requests/{externalId}/activate
-
GET
/v1/crypto/cert-requests/{externalId}/print
-
GET
/v1/crypto/eio
-
POST
/v1/crypto/cert-requests/eio
-
GET
/v1/crypto/cert-requests/eio/{externalId}/state
-
POST
/v1/crypto/cert-requests/eio/{externalId}/activate
-
POST
/v1/crypto/cert-requests/eio/{externalId}/print
-
GET
/v1/client-info
-
GET
/v1/correspondents/rur
-
GET
/v1/dicts?name
- Обновили формат описания для следующих ресурсов:
17.03.2025
-
Обновили формат описания для следующих ресурсов:
-
Описали коллекции запросов. Этот инструмент разработчика поможет тестировать и интегрировать быстрее.
-
В "Бизнес-картах" описали новые методы для переводов по СБП.
-
В "Зарплатный проект" вернули методы для открытия счетов и выпуска карт Сбера.
01.03.2025
- Добавили в модель
/ic/sso/api/v2/oauth/authorize
новый необязательный параметр prompt. - В больших файлах
/fintech/api/v1/files/upload
указали актуальные форматы файлов для загрузки в Банк. - В сведения о владельце сертификата добавлены необязательные атрибуты SN и GN.
- Указали допустимый ТПС для эндпоинтов связанных с функционалом выписки.
- Добавили новый раздел "Коллекция готовых запросов".
Ноябрь
29.11.2024
Вообще наша документация рассчитана на широкий круг специалистов. Тем не менее мы разделили пользователей на две основные группы: бизнес-пользователи (руководители компаний, проектов, владельцы продуктов, а налитики и другие) и разработчики (архитекторы, программисты, тестировщики).
Задача очевидна – сделать документацию удобной для всех. В течение года наша команда работала над подробным описанием всех сервисов в Sber API.
Итогом этой работы стало разделение документации на два раздела: «Бизнес-сценарии» — для бизнес-пользователей и «Справочник API» — для разработчиков. Пользуйтесь!
Отметим, что раздел «Бизнес-сценарии» будет полезен не только для бизнеса, но и для системных аналитиков, поскольку содержит диаграммы последовательности, которые подробно описывают взаимодействие вашей системы с Sber API в рамках интеграции.
Что изменилось?
- Основное навигационное меню
Теперь оно станет проще и интуитивно понятнее. Уходим от сложных терминов вроде "Host-to-host", "Holdings", "B2BSaaS" и прочих сокращений. Все стало логичнее:
- Для бизнес-пользователей – раздел "Бизнес-сценарии",
- Для разработчиков – "Справочник API".
Разделы "Другие b2b-решения" и "Дру гие API решения" больше не нужны – вся необходимая информация теперь аккуратно распределена по соответствующим категориям. - Разводящая страница раздела «Бизнес-сценарии»
При нажатии на этот раздел вы попадете на страницу, которая поможет точнее определить задачу пользователя документации.
Например, зайдя в раздел «Платежи и переводы», вы увидите все сервисы, которые связаны с переводом средств, включая сопутствующие возможности. - Раздел "Справочник API"
Выбрав «Справочник API», вы попадете на страницу, где на первом уровне представлены все ресурсы (объекты), с которыми можно взаимодействовать через API. На втором уровне – сами API-запросы для этих ресурсов. - Отдельная страница с описанием API-запроса
22.11.2024
- Сервис «Большие файлы» — ваш помощник в работе с документами.
С его помощью вы сможете загружать документы в банк для различных целей. Например:
• предоставление документов в валютный контроль банка;
• экспорт файлов с выписками по счетам для импорта в другие системы.
Чтобы вашей команде было проще разобраться, как технически реализовать функционал, мы добавили диаграммы последовательности. Это сэкономит время и силы на этапах проектирования и тестирования интеграции.
Все запросы API описаны в унифицированном формате, который знаком вам по другим сервисам.
20.11.2024
- Мы объединили два раздела в один. Теперь все, что касается Sber API для внешнеэкономической деятельности – в новом разделе «ВЭД».
Также мы добавили наглядное описание работы сервиса, чтобы вы понимали, какие возможности он предоставляет с помощью API.
В этом обновлении мы использовали унифицированное описание для схем моделей запросов и ответов, чтобы обеспечить единообразие при работе с каждым сервисом.
15.11.2024
- Мы изменили ответ на запрос Получение информации по бизнес-картам
/fintech/api/v2/сorporate-cards/transfer/list
. Теперь он включает данные о лимитах по бизнес-карте. - Исправили ошибку в описании запроса Создание заявления на перевод по бизнес-карте
/fintech/api/v2/corporate-cards/transfer/commission
. Ранее поляreceiverInfo
иsenderInfo
ошибочно указывались как массивы, теперь они правильно описаны. - Для следующих API-запросов добавили ошибку 429 (Too Many Requests):
- GET
/v2/statement/transactionId/print
- GET
/v2/statement/summary
- GET
/v2/statement/transactions
- GET
/v2/statement/transactionId
- GET
/v1/statement/print
- GET
/v1/statement/download/{fileId}
- GET
/v2/statement/increment
- GET
/v1/files/tasks-for-download/{taskId}
- GET
/v1/statement/files
- POST
/v1/payment-requests/outgoing
- GET
/v1/payment-requests/outgoing/\{externalId\}/state
- POST
/v1/payrolls
- GET
/v1/payrolls/\{externalId\}/state
- GET
/v1/payrolls/\{externalId\}
- GET
/v1/salary-agreements
- GET
11.11.2024
- Подробнее описали возможные ошибки, которые могут возникнуть при получении, обновлении и отз ыве access_token. Это поможет вам уменьшить количество проблем у пользователей при авторизации через СберБизнес ID.
01.11.2024
-
Обновили данные о том, как работает механизм автоматического платежа в сервисе Корпоративные подписки, когда на счете плательщика недостаточно средств для списания.
-
Удалили раздел Тарификация в связи с отсутствием платы за подключение и использование Sber API
-
В запросе /fintech/api/v1/acceptance-advances/{externalId} изменили обязательность атрибута date в ответе 200 (OK) - было required, стало optional
-
Изменили формат возвращаемых в ответе на запрос
/ic/sso/api/v2/oauth/user-info
Получение информации (user-info) значений для следующих атрибутов (claim):Наименование атрибута (claim) Было Стало tbIdentCode "tbIdentCode": "38" "tbIdentCode": "10000367" terBank "terBank": "Московский Банк Сбербанка РФ" "terBank": "Московский банк" orgLawFor "orgLawForm": "Открытое акционерное общество" "orgLawForm": "Открытые акционерные общества" -
Перестанут возвращаться в ответе на запрос
/ic/sso/api/v2/oauth/user-info
Получение информации (user-info):- summOfferSmartCredit (Сумма предодобренного предложения по смарт-кредитам)
- offerSmartCredit (Предодобренные предложения по смарт-кредитам)
-
В ответе на запрос
/ic/sso/api/v2/oauth/user-info
Получение информации (user-info) будет возвращаться новай атрибут - emailConfirmed (Адрес электронной почты пользователя подтвержден)
Октябрь
25.10.2024
-
В запросах /fintech/api/v1/acceptance-advances/{externalId} и /fintech/api/v1/acceptance-advances/{externalId}/state в описание к ошибке 404 Not found добавили информацию о возможности удаления документа Пользователем
-
В запросах /fintech/api/v1/payments/from-invoice, /fintech/api/v1/payments/from-invoice-any и /fintech/api/v1/payments/from-invoice-budget скорректировали регулярное выражение для атрибута rate из объекта vat
Было Стало ^[0-9]2$ ^(0|10|20)$
16.10.2024
Убрали из документации описание запросов API, по которым прекращаем поддержку.
Они скоро будут полностью отключены с тестового и промышленного стендов для всех потребителей.
Группа | Endpoint |
---|---|
Заявления об акцепте/отказе от акцепта | /v1/acceptance-letters |
Заявления об акцепте/отказе от акцепта | /v1/acceptance-letters/{externalId}/state |
Ведомости банковского контроля | /v1/bank-control-statements/change-applications/{externalId}/state |
Ведомости банковского контроля | /v1/bank-control-statements/change-curr-contracts |