ym88659208ym87991671
Сервис «Корпоративные подписки» | Документация для разработчиков

Сервис «Корпоративные подписки»

Обновлено 28 марта 2025

Информация о сервисе

Корпоративные подписки – это сервис для организации расчетов с юридическими лицами (ЮЛ) и индивидуальными предпринимателями (ИП), который позволяет получать сведения о подписчиках и безакцептно списывать денежные средства за предоставление услуг или товаров.

Ядро механизма сервиса составляют платежные требования, которые используются в качестве платежных документов для расчетов между компаниями.

Платежное требование

Платежное требование - это документ, используемый для безналичных расчетов между юридическими лицами, в котором поставщик предъявляет должнику претензию за неуплату задолженности по договору. Банк на основании этого документа списывает сумму задолженности со счета плательщика в пользу получателя.

Основное различие между платежным требованием и платежным поручением заключается в инициаторе платежа. В платежном поручении инициатором является владелец счета, тогда как в платежном требовании - получатель денег (кредитор, поставщик, продавец или исполнитель услуг). Кредитор оформляет платежное требование и направляет его в банк для исполнения. Часто для выполнения платежного требования требуется акцепт (согласие) плательщика.

Платежные требования могут быть с предварительным акцептом или без него. Акцепт - это согласие должника оплатить задолженность в определенный срок. Если акцепт не предусмотрен договором, то срок составляет 5 рабочих дней. Без акцепта банк имеет право списать деньги с расчетного счета клиента в определенных случаях, например, по решению суда на основании исполнительных документов.

Другая часть механизма построена на предварительном акцепте (у себя мы его называем Заранее данный акцепт - ЗДА) на списание денежных средств со счета подписчика.


Терминология

  • Заранее данный акцепт (далее по тексту - ЗДА) – временное согласие Клиента на списание денежных средств в счет оплаты предоставленных услуг или товаров по подписке. Наличие Заранее данного акцепта позволяет по запросу от вашей компании Банку списывать средства со счета Клиента без дополнительного согласования.
  • Оформить Подписку – подписать Заявление на Заранее данный акцепт.
  • Исходящее Платежное требование (далее по тексту - ИПТ) – расчетный документ, на основании которого Банк списывает денежные средства со счета Клиента-подписчика.
  • Digest ИПТ – набор значимых полей платежного документа, который подписывается электронной подписью (ЭП).

Схема работы сервиса

Схема работы сервиса

Варианты реализации

В рамках Платформы вы самостоятельно разрабатываете ролевую модель и настраиваете права доступа к функциональности.

Ниже, в качестве примера, приведена диаграмма вариантов использования:

Варианты реализации
Оформление подписки

Для наличия возможности без акцептного списания денежных средств со счета Клиента потребуется получить от него согласие на автоматические списания. Его получить можно при оформлении Подписки пользователем Клиента. Клиент становится подписчиком после заключения договора с вашей компанией или акцепта Оферты вашей Платформы и оформления ЗДА на списание платы за подписку на основании заключенного договора/акцепта Оферты.


Шаги

  1. Сформировать черновик ЗДА
  2. Подписать черновик ЗДА
  3. Проверить статус подписания ЗДА
  4. Проверить подписанный ЗДА

Участники usecase

  • Пользователь - представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформы)
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Пользователь имеет пользовательский профиль в СберБизнес своей компании
  • Пользователь находится в пространстве Платформы
  • Пользователь прошел авторизацию с помощью СберБизнес ID

Результат применения

  • Платформа получила подтверждение оформления Подписки (подписан документ заявление на ЗДА)
Оформление подписки

Используемые запросы

№МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/fintech/api/v1/acceptance-advancesСоздание черновика заявления ЗДАACCEPTANCE_ADVANCE1. Сформировать черновик ЗДА
2Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid1. Сформировать черновик ЗДА
3Alt text/fintech/api/v1/acceptance-advances/{externalId}/stateПолучение статуса заявления ЗДАACCEPTANCE_ADVANCE3. Проверить статус подписания ЗДА
4Alt text/fintech/api/v1/acceptance-advances/{externalId}Получение заявления ЗДАACCEPTANCE_ADVANCE4. Проверить подписанный ЗДА
Списание платы за подписку

Выставить платежное требование Клиенту можно не раньше даты, следующей за датой оформления Подписки.

Например, Пользователь Клиента оформил Подписку 15 января. На следующий день, 16 января, можно будет сформировать платежное требование для списания денежных средств. Если сформировать платежное требование в день оформления Подписки, то платежное требование исполнено не будет - оно встанет в "Картотеку" в СберБизнес Клиента на ручное подтверждение.


В схеме можно использовать автоматизированное подписание документа. Данная возможность доступна только при использовании ЭЦП сотрудника вашей компании.

Подробнее об использовании ЭЦП в Sber API можно почитать в одноименном разделе.


Шаги

  1. Проверить актуальность подписки
  2. Создать и подписать ИПТ

Участники usecase

  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Успешно выполнен сценарий "Оформление подписки"
  • Платформа сохранила идентификатор (extertalId) заявления на ЗДА, созданного в сценарии "Оформление подписки"
  • У Платформы есть access_token пользователя вашей компании

Результат применения

  • Платформа создала ИПТ
Списание платы за подписку

Используемые запросы

№МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/fintech/api/v1/acceptance-advances/{externalId}/stateПолучение статуса заявления ЗДАACCEPTANCE_ADVANCE1. Проверить актуальность подписки
2Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid1. Проверить актуальность подписки
и
2. Создать и подписать ИПТ
3Alt text/fintech/api/v1/payment-requests/outgoingСоздание платежного требованияPAYMENT_REQUEST_OUT2. Создать и подписать ИПТ
Проверка статуса оплаты

Шаги

  1. Проверить статус оплаты

Участники usecase

  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предварительные условия

  • Успешно выполнен сценарий "Списание платы за подписку"
  • Платформа сохранила идентификатор (extertalId) ИПТ, созданного в сценарии "Списание платы за подписку"
  • У Платформы есть access_token пользователя вашей компании

Результат применения

  • ИПТ исполнено Банком
Проверка статуса оплаты

Используемые запросы

№МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/fintech/api/v1/payment-requests/outgoing/{externalId}/stateПолучение статуса платежного требованияPAYMENT_REQUEST_OUT1. Проверить статус оплаты
2Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid1. Проверить статус оплаты

Подписание заявления на ЗДА

Чтобы Сбер обработал сформированный черновик заявления ЗДА, клиенту необходимо его подписать. Клиент может его подписать в личном кабинете СберБизнес, либо сформируйте и направьте пользователю ссылку вида:

{контур банка}**/ic/ufs/advance-acceptance/index.html#/advance-acceptance-creator/{externalId}?backUrl={backUrl}

Ссылку можно разместить под кнопкой в вашем интерфейсе или отправить в явном виде. При переходе по ссылке откроется окно с функциональностью подписания заявления. После успешного подписания сервис вернет пользователя по указанному в ссылке URL.

Ссылка переадресации выглядит следующим образом:

{контур банка}/ic/ufs/advance-acceptance/index.html#/advance-acceptance-creator/{externalId}?backUrl={backUrl}

ПеременнаяОписаниеДополнительная информация
{контур Банка}адрес Банка, на который делается запрос для открытия страницы сервиса подписания заявленияДля корректного выбора контура Банка потребуется определить тип криптопрофиля пользователя Клиента.
В рамках запроса /v1/oauth/user-info вы получаете данные по Клиенту, в том числе атрибут userCryptoType.
Атрибут позволяет определить криптопрофиль пользователя - SMS (СМС) или Token (электронный ключ (токен)).

- Тестовый контур https://efs-sbbol-ift-web.testsbi.sberbank.ru:9443
- Промышленный контур СМС-пользователь https://sbi.sberbank.ru:9443
- Промышленный контур Токен-пользователь http://localhost:28016
{externalId}уникальный идентификатор заявленияДанный идентификатор присваивает ваша Платформа на шаге создания черновика заявления на ЗДА.
{backUrl}страница возврата, на которую Банк вернет пользователя Клиента после успешного подписания черновика заявления- Если не указать backUrl в ссылке, пользователи не смогут после подписания вернуться на Платформу;
- Если backUrl будет отличаться от адреса вашей платформы, который указали при регистрации в Банке, то при возврате клиента на backUrl он будет видеть ошибку.

Отзыв согласия на ЗДА

Для отмены подписки на сервис клиенту необходимо отозвать согласие на ЗДА.

Существует два способа отзыва согласия на ЗДА:

  • Клиент может самостоятельно отменить подписку в СберБизнесе. Для этого ему необходимо перейти в меню СберБизнеса: Запросы на оплату - Акцепты - Заявления на заранее данный акцепт;
  • Реализуйте сценарий отзыва согласия на ЗДА на вашей платформе. Для этого сформируйте и направьте пользователю ссылку вида:
{контур банка}/ic/ufs/advance-acceptance/index.html#/advance-acceptance-revoke/{externalId}

Например, ссылку можно разместить под кнопкой в вашем интерфейсе или отправить в явном виде. При переходе по ссылке откроется окно с функциональностью отзыва согласия.

ПеременнаяОписаниеДополнительная информация
{контур Банка}адрес Банка, на который делается запрос для открытия страницы сервиса подписания заявленияДля корректного выбора контура Банка потребуется определить тип криптопрофиля пользователя Клиента.
В рамках запроса /v1/oauth/user-info вы получаете данные по Клиенту, в том числе атрибут userCryptoType.
Атрибут позволяет определить криптопрофиль пользователя - SMS (СМС) или Token (электронный ключ (токен)).

- Тестовый контур https://efs-sbbol-ift-web.testsbi.sberbank.ru:9443
- Промышленный контур СМС-пользователь https://sbi.sberbank.ru:9443
- Промышленный контур Токен-пользователь http://localhost:28016
{externalId}уникальный идентификатор заявленияДанный идентификатор присваивает ваша Платформа на шаге создания черновика заявления на ЗДА.

В таком случае при вызове метода /v1/partner-info/advance-acceptances в поле "active" вы получите значение "false".

Дополнительная информация

Назначение платежа

Назначение должно раскрывать экономический смысл платежа.

  • Сведения должны быть лаконичными — у поля есть ограничения по знакам 210 символов.
  • В назначении необходимо указать реквизиты документа, по которому вы осуществляете платеж, например, номер договора или счета.
  • Рекомендуем указывать конкретный предмет оплаты.
  • Если платеж с НДС, необходимо прописать точную сумму налога.
    Ниже подробнее рассказали о формировании информации об НДС в назначении платежа.

Рекомендуемый вариант заполнения:

Оплата по договору [номер договора] от [дата договора]. НДС [ставка НДС]% - [сумма НДС] рубля [способ расчета НДС]. [Любая ваша информация]

Параметры НДС

Чтобы все работало правильно, нужно передать такие параметры:

  • Если НДС не указан, то по умолчанию будут использованы эти значения: 
    "vat": {
      "type": "NO_VAT",
      "rate": "0",
      "amount": "0.00"
    }
    Важно: в поле «Назначение платежа» обязательно укажите НДС не облагается.
  • Если выбрали «type» — INCLUDED (НДС включен в сумму платежа), то в поле «amount» укажите сумму НДС. Значение «rate» должно быть 10 или 20. В поле «Назначение платежа» обязательно укажите посчитанную сумму НДС. Пример правильного заполнения: НДС 10% — 100.63 рубля (пробел обозначается нижним подчеркиванием, символ не ставится). Если процентное значение не указано, то дефис перед суммой ставить не нужно: НДС 100.63 рубля.
  • Если выбрали «type» — MANUAL (ввод НДС вручную), то поле «amount» заполнять необязательно, но по умолчанию сумма НДС будет равна нулю. Если же поле «amount» заполнено, то укажите нужную сумму НДС в соответствии с форматом. Если процентное значение не указано, то дефис перед суммой ставить не нужно: НДС 100.63 рубля.

FAQ

Будет ли исполнено Банком платежное требование, отправленное выходные или праздничные дни?

Исходящие платежные требования, созданные после 16:50 часов (по Московскому времени) в пятницу, начинают обрабатываться в следующий понедельник.

Что происходит если денежных средств на счете клиента недостаточно?

В случае недостатка денежных средств на счете клиента для оплаты, банк ожидает поступления средств на счет клиента в полном объеме до конца календарного дня. Если деньги на счете клиента не появятся в полном объеме в течении указанного срока, платежное требование перейдет в статус REFUSEDBYBANK ("Отвергнут банком или Отклонен банком").

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