ym88659208ym87991671
История обновлений - Sber API | Документация для разработчиков

История обновлений

Обновлено 28 мая 2024

В этом разделе вы найдете историю обновлений и изменений документации.

Май

28.05.2024

Опубликовали описание сервиса Безопасные сделки.

Безопасные сделки это технология Сбера для защищенных расчетов между контрагентами. Технология предоставляет возможность интеграции по API для торговых площадок (Маркетплейсов), позволяет осуществлять безопасные расчеты покупателей (бенефициаров) с продавцами (поставщиками).

15.05.2024

С 01.06.2024 года отменена комиссия в канале Sber API.

08.05.2024

  • Исправили орфографические ошибки и поправили некоторые формулировки (сделали их легче для восприятия)
  • Добавили уточнение к описанию атрибута type в ресурсе /v1/files/upload:

    Поддерживаемые форматы файлов к валютным документам: pdf, jpeg, jpg, png, tiff, tif, pcx
    Максимальный размер файла: 30 мб

    Поддерживаемые форматы файлов к остальным документам: doc, docx, xls, xlsx, ppt, pptx, csv, dbf, rtf, txt, pdf, jpg, png, gif, bmp, tiff, zip, rar, arj, xml, jpeg
    Максимальный размер файла: 50 мб
  • Добавили уточнение к описанию атрибута bic (БИК банка сотрудника) ресурсе /v1/payrolls: заполняется в случае, если счет сотрудника открыт не в СберБанке

06.05.2024

Провели рефакторинг механизма работы сервиса Корпоративные подписки:

  • В рамках сервиса СберБизнес ID пользователь Клиента подписывает только Согласание на передачу данных
  • Акцепт оферты происходит через Платформу Партнера
  • Создание Заранее данного акцепта происходит отдельным шагом после подписания Согласия на передачу данных

На странице сервиса:

  • Обновили общую схему сервиса
  • Скорректировали детализированные sequince-диаграммы по функциональности "Оформить подписку" и "Списание платы за использование сервиса"
  • Добавили используемые ресурсы для реализации механизмов

Апрель

23.04.2024

С 1 апреля 2024 года для ряда ресурсов сменился тип тарификации с тарифицируемого на служебные.

Актуальную информацию по тарификации Sber API можно посмотреть на соответствующей странице.

18.04.2024

Изменения по сервису "Кредит в корзине":

  • На странице сервиса актуализировали скриншоты модальных окон
  • Обновили SDK Виджета подключения в Инструкции по установке
  • В описании убрали информацию о рассрочке и скорректировали формулировки на кнопках

12.04.2024

  • Для ресурса /v1/statement/print скорректировали описание: в модели ответа параметр "taskId" переименовали в Number и в примере ответа указали корректный пример. Ответ приходит обычным номером, а не JSON.
  • Для ресурса /v1/statement/files скорректировали описание: в модели ответа параметр "taskId" переименовали в Number и в примере ответа указали корректный пример. Ответ приходит обычным номером, а не JSON.
  • Для ресурса /v1/files/tasks-for-download скорректировали описание:
    • в модели запроса уточнили способ указания идентификатора задачи на скачивание - он указывается в path-параметре
    • в модели ответа уточнили статусы состояния ссылки на загрузку выписки
  • Внесли небольшие корректировки по тексту (исправили опечатки)
  • В целях усиления мер обеспечения кибербезопасности при предоставлении информации, относящейся к банковской тайне и содержащей персональные данные Клиента при использовании ресурса /v1/files/upload можно загружать файлы на ресурс Банка для дальнейшей привязки к документу в форматах pdf, jpeg, jpg, png, tiff, tif, pcx.
    Форматы файлов txt, doc, docx, rar, zip не будут приняты в обработку в канале Sber API.

Обращаем ваше внимание, что вам необходимо выполнить доработки по форматам файлов для их отправки с помощью ресурса /v1/files/upload в срок до 15 мая 2024. После указанного срока форматы txt, doc, docx, rar, zip по загрузке файла к валютным документам будут выведены из эксплуатации.

05.04.2024

02.04.2024

Провели редизайн описания сервиса Корпоративные подписки. Что изменилось:

  • структура подачи информации стала логичнее и понятнее;
  • упростилась общая схема работы сервиса;
  • сформированы и добавлены подробные схемы разработки функциональности при помощи сервиса;
  • в едином стиле переформатированы описания всех используемых в сервисе ресурсов;
  • для каждого ресурса создано описание возможных ошибок и способов их решения.

Март

29.03.2024

Банк начинает процесс перехода на использование подписи в формате CaDES-BES.

  • В части подписи банка запланированы доработки по переходу на формат CaDES-BES. Начиная с 01.05.2024 подпись банка может приходить как в текущем raw-формате, так и в формате CaDES-BES. В период с 01.05.2024 по 30.09.2024 вам необходимо обеспечить одновременную поддержку проверки подписи банка текущего raw-формата и нового CaDES-BES.
    Подпись банка будет в формате CaDES-BES:
    • Подпись открепленная – detatched. Алгоритм цифровой подписи ГОСТ Р 34.10-2012 для ключей длины 256 бит.
    • Блок с сертификатами (Certificates) включает сертификаты подписанта и промежуточные сертификаты.

В качестве корневого сертификата будет использован сертификат Минцифры. Для проверки подписи банка скачайте корневой сертификат на портале УФО (gosuslugi.ru).

  • В ряде запросов Банк предлагает возможность получение ответа в формате JOSE в представлении JWS Compact Serialization.
    Из заголовока (Header) получаемого JWS будет исключен UUID сертификата технологического криптопрофиля банка, которым подписан JOSE.
  • Изменения в ресурсах /v1/crypto и /v1/crypto/eio
    В связи с тем, что блок с банковскими сертификатами для проверки подписи будет передаваться в составе подписи банка, из ответов /v1/crypto и /v1/crypto/eio будут исключены данные о банковских сертификатах:
    • certBank – сертификат технологического криптопрофиля банка;
    • certBankUuid – уникальный идентификатор сертификата технологического криптопрофиля банка.

Помимо изменений в подписи Банка, убедитесь, что используемые вами электронные цифровые подписи (ЭЦП) в Sber API соответствуют всем необходимым требованиям и условиям.

БылоСтало
- Подпись CMS;
- Подпись открепленная — detatched;
- Формат подписи — PEM;
- Алгоритм цифровой подписи ГОСТ Р 34.10-2012 для ключей длины 256 бит;
- Блок с сертификатами (Certificates) обязателен — включает сертификат подписанта;
- Данные подписанта (Signer Info) — содержит информацию только по одному подписанту;
- Подпись CaDES-BES в формате PEM;
- Подпись открепленная — detatched;
- Алгоритм цифровой подписи ГОСТ Р 34.10-2012 для ключей длины 256 бит;
- Блок с сертификатами (Certificates) обязателен — включает сертификат подписанта;
- Данные подписанта (Signer Info) — содержит информацию только по одному подписанту;
- Присутствует время формирования подписи (Signing Time).

27.03.2024

В рамках сервиса СберБизнес ID вы дважды получаете ID_token:

  1. При получении токена доступа (access_token) - токен используется для подтверждения успешной авторизации пользователя
  2. При получении информации по организации и пользователю с помощью ресурса /v2/oauth/user-info - токен содержит информацию о клиенте

В обоих случаях ID_token представлен в виде JSON Web Token (JWT). Токен также содержит данные электронной подписи Банка, которая подтверждает подлинность полученных данных. Публичный ключ используется для проверки подписи Банка.

25.03.2024

  • В сервисе Большие файлы у ресурса Получение статуса загрузки /v1/files/upload/{fileId}/state скорректировали статусную модель - убрали неактуальный статус ATTACH_ERROR
  • Выводим из эксплуатации ресурсы сервиса Управление тарифными планами - страница сервиса больше недоступна
  • Внесли небольшие правки в формулировки описания функциональности Личного кабинета - текст стал понятнее и легче воспринимается
  • Скорректировали опечатку в схеме обновления access_token - при запросе с просроченным access_token СберБизнес ID возвращает ответ 401 Unauthorized

22.03.2024

Провели редизайн описания сервиса Моментальные платежи:

  • Сформировали и добавили подробную схему работы сервиса.
  • В едином формате сформировали описание всех используемых в сервисе ресурсов;
  • Для каждого ресурса сформулировали описание возможных ошибок и способов их решения.

13.03.2024

  • Теперь при запросе информации по кредитным предложениям через ресурс /v1/credit-offers, параметр checkSum может содержать до 16 символов, вместо предыдущих 10.
  • При создании заявки на кредитный договор через ресурс /v1/credit-requests в параметре orderId длина строки ограничена 50 символами - указали эту информацию в модели запроса.
  • Требование заполнения параметра Number при запросе на выпуск нового сертификата стало обязательным как для ресурса /v1/crypto/cert-requests, так и для ресурса /v1/crypto/cert-requests/eio.
  • При получении реестра платежей с использованием ресурса /v1/payments-registry вы получаете информацию о платежах физических лиц, принятых и перечисленных банком на ваш расчетный счет - внести это примечание.

12.03.2024

Провели редизайн описания сервиса СберБизнес ID:

  • Сформировали и добавили подробную схему работы сервиса.
  • Расширили информацию о способе получения кода авторизации (authorization code) для последующего обмена на токены доступа (access_token) и обновления (refresh_token).
  • В едином формате сформировали описание всех используемых в сервисе ресурсов;
  • Для каждого ресурса сформулировали описание возможных ошибок и способов их решения.

Информируем вас о том, что, начиная с 12.03.2024 г., в ответе на запросы /oauth/authorize и /oauth/token в значение кода авторизации, формируемое в произвольном формате UUID, а также в параметрах access_token и refresh_token постепенно перестанут добавляться на конце значение «1» или «2» через дефис и использоваться формат UUID. При этом, количество символов в строке останется неизменным и равным 38 символам.
Регулярное выражение получаемых значений будет следующим: ^([a-zA-Z0-9]){38}$

Февраль

28.02.2024

На странице Зарплатная ведомость добавили новые возможные статусы зарплатной ведомости, которые приходят в ответ на запрос GET-ресурса /v1/payrolls/{externalId}/state.

Новые добавленные статусы:

СтатусЗначениеСостояние
TRANSITТранзитныйПромежуточный/Продолжать опрашивать
WAITING_FOR_ORDERОжидает распоряженияПромежуточный/Продолжать опрашивать
WAITING_FOR_MIGRATIONОжидает миграцииПромежуточный/Продолжать опрашивать
EXPORTINGВыгружаетсяПромежуточный/Продолжать опрашивать
TEMPLATEШаблонКонечный/Прекратить опрашивать

21.02.2024

15.02.2024

Провели редизайн описания сервиса Бизнес-карты для H2H интеграции:

  • Представили возможности сервиса с точки зрения функциональности;
  • Функциональность представили в виде сценариев с подробными инструкциями по их реализации;
  • В едином формате сформировали описание всех используемых в сервисе ресурсов;
  • Для каждого ресурса сформулировали описание возможных ошибок и способов их решения.

10.02.2024

Изменили тарификацию ресурса GET /v1/corporate-cards: с 01.02.2024 он становится бесплатным. Актуальную информацию по тарификации Sber API можно посмотреть на соответствующей странице.

Декабрь

20.12.2023

  • 20 декабря команда Sber API объединила документацию на витрине API по двум каналам — Sber API и SberBusinessAPI — для улучшения клиентского опыта. В результате этого изменения был добавлен новый раздел под названием "Другие API-решения", который включает в себя описания публичных API:
  1. Аккредитивы ФЛ (физические лица)
  2. Аккредитивы ЮЛ (юридические лица)
  3. Сервис управления сертификатами аутентификации
  4. Оценка деловой репутации и фрод
  5. Плати QR
  6. SberVisor
  • Обращаем внимание, получение статуса по ранее созданным платежным требованиям возможно не позднее 01.11.2022 г. Все документы, созданные позднее указанной выше даты возвращаться в ответе не будут. Просьба учитывать данную информацию в запросах.

Ноябрь

14.11.2023

Перенесли ресурсы из корпоративных подписок в другие API-решения

  • Информация по офертам клиента
  • Информация по тарифам сервисов
  • Клиенты с небанковскими сервисами
  • Получение документа по списанию средств
  • Списание платы за использование сервиса

02.11.2023

Сентябрь

25.09.2023

Обновлена страница "С чего начать":

  • Изменен заголовок с "Приступая к работе" на "С чего начать"
  • Обновлено содержимое страницы "С чего начать"
  • Добавлен подраздел "Шаги подключения" в раздел "С чего начать"
  • Обновлено содержимое страницы Личный кабинет
  • Добавлены страницы Функции личного кабинета, и Роль разработчика SberBusinessAPI в подраздел Личный кабинет вместо текущих страниц
  • Обновлено содержимое страницы TLS

11.09.2023

Добавлено примечание на страницу

Август

25.08.2023

Обновлен раздел создание и отправка в банка b2b/b2p-перевода с бизнес-карт:

24.08.2023

  • Добавлены описания услуг h2h, b2bsaas и холдинга.
  • Добавлена ​​инструкция как подключить дочернюю компанию для холдинга.

23.08.2023

Добавлены обучающие видео в следующие разделы:

Формирование запроса на сертификат Криптография и отправка РПП Обновление client_secret Обновление пары access token/refresh token Получение кода авторизации

Июль

13.07.2023

Обратите внимание: для сохранения доступа к тестированию сервисов канала SberBusinessAPI необходимо перейти на новый тестовый контур ИФТ. При переходе на новый тестовый контур с вашей стороны доработок учетной системы не потребуется. TLS сертификат останется прежним. В ближайшее время текущий тестовый контур EDUPIR будет недоступен.

Июнь

20.06.2023

C 02.07.2023 по 01.10.2023 всем Партнерам при В2В интеграции (когда файл с выпиской запрашивается по счетам Клиентов) необходимо сделать доработки на своей стороне: при получении ссылки на скачивание файла с выпиской по ресурсу GET /v1/files/tasks-for-download скачивать файл под своим TLS-сертификатом в свое хранилище и передавать ссылку Клиенту на свое хранилище, в котором уже не будет проверки TLS-сертификата.

Апрель

25.04.2023

Добавьте сертификаты НУЦ Минцифры для работы по СберБизнесID

Обратите внимание: для сохранения доступа к сервису СберБизнесID от Сбера в срок до 11.05.2023 вам необходимо произвести настройки и добавить доверенные сертификаты НУЦ Минцифры в настройки системы. Подробности по ссылке https://www.sberbank.ru/ru/certificates.

Если не выполнить эту настройку, интеграция со СберБизнесID станет недоступна.

17.04.2023

  • Исправили пример запроса POST /v1/files/download.

  • Изменили типы данных для нескольких полей в модели ответа GET /v1/credit-offers:

    НаименованиеБылоСтало
    sumMaxnumber(19,2)string
    sumMinnumber(19,2)string
    ratenumber(19,2)string
    availableSumnumber(19,2)string

04.04.2023

Добавили ресурсы v2 по получению выписки в список тарифицируемых:

/v2/statement/transactions

/v2/statement/transactionId

/v2/statement/transactionId/print

/v2/statement/summary

Март

30.03.2023

Изменили Условия доступности покупки в кредит для сервиса «Кредит в Корзине»:

  • ОПФ организации - ИП/ООО/ГКФХ.
  • Дата создания организации 6 или более месяцев от текущей даты.

20.03.2023

Изменили формулировку в разделе Получение TLS.

Было: файл с запросом на сертификат передать своему куратору.

Стало: файл с запросом на сертификат необходимо направлять на п/я supportdbo2@sberbank.ru.

14.03.2023

С 03.04.2023 добавляем новые ресурсы по получению выписки v2/, которые заменят аналогичные ресурсы v1/:

  • /v2/statement/transactions
  • /v2/statement/transactionId
  • /v2/statement/transactionId/print
  • /v2/statement/summary

Что изменится:

1. При запросе выписки по счету Клиент будет использовать новый ресурс /v2/statement/transactions:

  • на входе будет указывать Дату + Счет;
  • на выходе получать Выписку с операциями, где у каждой операции будет стоять идентификатор (operationId). Важно, данный operationId – это уникальный ID операции, по нему Клиент сможет запросить реквизиты операции в форматах json либо печатной форме.

2. При запросе реквизитов операции по выписке Клиент будет использовать новые ресурсы /v2/statement/transactionId и /v2/statement/transactionId/print:

  • на входе будет указывать Дату + Счет + operationId + формат печатной формы (при необходимости);
  • на выходе будет получать реквизиты операции по выписке в форматах json либо печатной форме.

14.03.2023

Вынесли Сервисы SberBusiness Payments в отдельный раздел.

09.03.2023

Удалили сервисы холдирования денежных средств на расчетном счете клиента: POST /v1/cash-hold/hold, GET /v1/cash-hold/hold/{externalId}/state, POST /v1/cash-hold/unhold, GET /v1/cash-hold/unhold/{externalId}/state, POST /v1/cash-hold/unhold-transfer, GET /v1/cash-hold/unhold-transfer/{externalId}/state.

Февраль

16.02.2023

C 18.03.2023 изменятся наименования статусов рублевого платежного поручения (ресурс GET /v1/ payments/{externalId}/state):

Код состояние документаНаименование статуса былоНаименование статуса стало
ACCEPTED_BY_ABSПринят АБСПринят
CARD2Картотека 2Ожидает оплаты
INVALIDEDSЭП/АСП не вернаПодпись неверна
REFUSEDBYBANKОтвергнут банкомОтклонен банком

08.02.2023

  • Исправили назначение статуса REFUSED_BY_RZK (был Промежуточным, стал Окончательным) для GET /v1/payments/{externalId}/state.

  • Убрали параметр sendReport из модели запроса и ответа POST /v1/card-issues.

Январь

18.01.2023

Добавили раздел Получение операций по счету в ОНЛАЙН режиме с обновленными ресурсами GET /v2/statement/transactions, GET /v2/statement/transactionId, GET /v2/statement/transactionId/print

Ноябрь

23.11.2022

Добавили обязательность заполнения поля payeeAccount для ресурса Создание платежных требований.

19.11.2022

Убрали параметры acceptStartDate и acceptLastDate из модели ответа GET /v1/partner-info/advance-acceptances.

Октябрь

19.10.2022

Добавили правило заполнения параметра payerKpp (КПП плательщика) для POST /v1/payments/from-invoice-budget.

В соответствии с Приказом Минфина России №107Н, если плательщик является ИП, то payerKpp необходимо заполнять значением "0".

Сентябрь

15.09.2022

Август

31.08.2022

  • Обновили архив с готовым тестовым TLS-сертификатом в разделе Получение TLS.

    Предыдущий TLS-сертификат действует до 04.09.2022.

  • Добавили пример отправляемого файла реестра задолженности в раздел Реестр задолженности.

  • Добавили пример получаемого файла реестра платежей в раздел Реестр платежей.

  • Исправили назначение статуса CHECKERROR (Был Промежуточным, стал Окончательным) для GET /v1/business-cards/transfer/{externalId}/state.

16.08.2022

Обновили сертификат TLS на стороне SberBusinessAPI.

Цепочка сертификатов, использованная при обновлении, отличается от предыдущей.

Чтобы обеспечить взаимодействие со SberBusinessAPI после обновления сертификата, нужно убедиться, что установлены все актуальные цепочки промышленных TLS-сертификатов, опубликованные в разделе Получение TLS (последнее обновление 26.04.2022).

Июль

26.07.2022

  • Обновили модель и пример запроса POST /v1/credit-requests.

  • Исправили назначения статусов: EXPORTED (был Окончательным, стал Промежуточным) и INVALIDEDS (был Промежуточным, стал Окончательным) для GET /v1/business-cards/transfer/{externalId}/state.

  • Добавили новые параметры: acceptLastDate (дата окончания периода действия заранее данного акцепта) и acceptStartDate (дата начала периода действия заранее данного акцепта) в модель ответа GET /v1/partner-info/advance-acceptances.

19.07.2022

05.07.2022

Июнь

03.06.2022

Май

19.05.2022

Добавили Зачисления в другие банки в раздел Прямая интеграция.

Апрель

26.04.2022

05.04.2022

04.04.2022

Отметили обязательность поля number (Номер документа) в ресурсе POST /v1/card-issues.

Март

30.03.2022

24.03.2022

Добавили новый раздел FAQ с ответами на часто задаваемые вопросы.

23.03.2022

22.03.2022

21.03.2022

  • Добавилась новая ошибка при создании валютных платежей - "bankStatus":"CHECKERROR", "bankComment":"Осуществление платежей в указанной валюте на данный момент невозможно". Это связано с тем, что в связи с санкционными ограничениями на валютные операции с корреспондентскими счетами в американских банках в Сбербизнес нельзя совершить перевод в другой банк в долларах США, фунтах стерлингов, датских и шведских кронах, канадских долларах.

  • Добавили условия доступности покупки в кредит в разделе Методы Кредит в Корзине.

11.03.2022

Обновили файл по ссылке КриптоПРО в разделе Криптографические ресурсы.

10.03.2022

Обновили кейсы для тестирования Кредит в Корзине.

01.03.2022

Обновили цепочки тестовых и промышленных TLS-сертификатов в разделе Приступая к работе.

Февраль

21.02.2022

Дополнили статусы обработки исходящего платежного требования.

Январь

27.01.2022

Исправили наименование сервиса, которое необходимо передать в scope для доступа к ресурсам Заявление о внесении изменений.

26.01.2022

Добавили правила заполнения полей сумма заказа (amount) и запрошенная сумма кредита (creditAmount) для ресурса Создание заявки на кредитный договор.

25.01.2022

Обновили файл по ссылке КриптоПРО в разделе Криптографические ресурсы.

Декабрь

28.12.2021

22.12.2021

Обновили и перенесли в отдельный раздел документацию по Сервису авторизации СберБизнес ID.

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.