История обновлений
В этом разделе вы найдете историю обновлений и изменений документации.
Июль
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 |