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

Сервис «Моментальные платежи»

Обновлено 25 июля 2025

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

Моментальные платежи – это сервис для организации расчетов, который позволяет формировать и отслеживать статус платежного поручения, где плательщиком выступает юридическое лицо или индивидуальный предприниматель, а получателем средств может быть юридическое лицо, физическое лицо или бюджетная организация.

До начала разработки интеграции с сервисом потребуется:

  • Заключить договор с Банком на использование сервиса "Моментальные платежи".
  • Завершить интеграцию со СберБизнес ID.

Без сервиса СберБизнес ID настроить работу "Моментальные платежи" невозможно.

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

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

Клиентский путь

Глазами Пользователя
ШагДействияСкрин
1Пользователь выбрал интересующий продукт и перешел к оплате.
Вы предлагаете авторизоваться с помощью СберБизнес ID.
Авторизация
2Нажал на "Войти по СберБизнес ID" и попал на станицу аутентификации.
Аутентификация
3После успешной аутентификации СберБизнес ID предлагает подписать Согласие.
Согласие


Подписание
4Платформа создала платежное поручение и переадресовала Пользователя на него.
Платежное поручение
5Пользователь выбрал счет списания и подписал платежное поручение.
Платежное поручение подписано

Возможные варианты реализации

Шаги, общие для каждого сценария:

  • Получить реквизиты перевода
  • Создать платежное поручение
  • Подписать платежное поручение

Предусловия

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

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

№МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/fintech/api/v1/client-infoПолучение расширенной информацииGET_CLIENT_ACCOUNTS1. Получить реквизиты перевода
2Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid1. Получить реквизиты перевода
3Alt text/fintech/api/v1/payments/from-invoiceСоздать черновик платежного поручения (отправка на свой счет в Сбербанке)PAY_DOC_RU_INVOICE2. Создать платежное поручение
Расчеты B2B и B2C
Расчеты B2B

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

№МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/fintech/api/v1/client-infoПолучение расширенной информацииGET_CLIENT_ACCOUNTS1. Получить реквизиты перевода
2Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid1. Получить реквизиты перевода
3Alt text/fintech/api/v1/payments/from-invoice-anyСоздать черновик платежного поручения (отправка в любой банк)PAY_DOC_RU_INVOICE_ANY2. Создать платежное поручение
Платежи в бюджет
Платежи в бюджет

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

№МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/fintech/api/v1/client-infoПолучение расширенной информацииGET_CLIENT_ACCOUNTS1. Получить реквизиты перевода
2Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid1. Получить реквизиты перевода
3Alt text/fintech/api/v1/payments/from-invoice-budgetСоздать черновик платежного поручения (отправка в бюджет)PAY_DOC_RU_INVOICE_BUDGET2. Создать платежное поручение
Проверка статуса и корректности оплаты

Время начала и частоту проверки статуса и корректности оплаты вы определяете самостоятельно исходя из своих бизнес-задач.

Для проверки статуса и корректности платежного поручения необходимо сохранить идентификатор (extertalId) платежного поручения, созданного в одного из сценариев выше

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

Переадресация на платежное поручение

Для выбора счета списания и подписания черновика платежного поручения необходимо сформировать ссылку и переадресовать по ней Пользователя Клиента.

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

{контур Банка}/ic/ufs/rpp-light/index.html#/payment-creator/{externalid}?backUrl={backUrl}

ПеременнаяОписаниеДополнительная информация
{контур Банка}адрес Банка, на который делается запрос для открытия страницы сервиса оплатыДля корректного выбора контура Банка потребуется определить тип криптопрофиля пользователя Клиента.
В рамках запроса /ic/sso/api//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 нужно закодировать URLEncode;
- Если не указать backUrl в ссылке, пользователи не смогут после подписания платежного поручения вернуться на Платформу;
- Если backUrl будет отличаться от адреса вашей платформы, который указали при регистрации в Банке, то при возврате клиента на backUrl он будет видеть ошибку.

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

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

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

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

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

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

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

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

  • Если НДС (объект "vat") не передан в запросе, то будут использованы эти значения: 
    "vat": {
      "type": "NO_VAT",
      "rate": "0",
      "amount": 0.00
    }

В поле «type» можно выбрать одно из следующих значений:

  • ONTOP - НДС рассчитан по указанной ставке и добавляется к сумме платежа. Необходимо в поле "amount" (сумма платежа) указывать итоговую сумму оплаты (с учетом НДС).
  • INCLUDED - НДС рассчитан по указанной ставке и включен в указанную сумму платежа. В поле «vat.amount» укажите сумму НДС. В поле «Назначение платежа» обязательно укажите посчитанную сумму НДС.
  • MANUAL - Рассчитан и введен вручную (для сложных процентных ставок). Поле «vat.amount» заполнять необязательно, но по умолчанию сумма НДС будет равна нулю. Если же поле заполнено, то укажите нужную сумму НДС в соответствии с форматом.
  • NO_VAT - НДС не облагается. В поле «Назначение платежа» обязательно укажите НДС не облагается.

Клиент вне зависимости от выбранного типа самостоятельно должен рассчитать конечную сумму к оплате и сумму НДС и указать эти значения в запросах. В поле "amount" (сумма платежа) указывается итоговая сумма платежа (с учетом НДС), в массиве "vat": поле amount указывается сумма НДС.

Пример заполнения: НДС 10% — 100.63 рубля или НДС 10%_100.63. Если процентное значение не указано, то дефис перед суммой ставить не нужно: НДС 100.63 рубля.

FAQ

Какой максимальный срок жизни можно установить для платежного поручения?

Дата истечения заказа устанавливается в соответствие с вашими бизнес-задачами вами атрибутом expirationDate в ресурсах /fintech/api/v1/payments/from-invoice и /fintech/api/v1/payments/from-invoice-any. Крайний срок действия платежного поручения от даты его формирования не может превышать 10 календарных дней.

Как отозвать сформированный черновик платежного поручения?

Отозвать сформированный черновик платежного поручения на вашей стороне нет технической возможности.

При использовании ресурсов "Моментальные платежи", которые создают черновики платежных поручений, черновики также появляются в СберБизнес Клиента. Через СберБизнес Клиент может самостоятельно отклонить черновик.

Как быстро Банк исполняет подписанное платежное поручение?

После подписания черновика платежного поручения Банк проводит ряд проверок. Обычно Банк исполняет подписанное платежное поручение в течение 1 минуты. В ряде случаев может потребоваться дополнительная информация от Клиента, что увеличит время исполнения документа.

Еще подробнее об исполнении и зачислении платежей в Справочном центре для бизнеса .

Откуда Банк берет реквизиты отправителя для платежного поручения?

В рамках сервиса СберБизнес ID вы реализуете механизм получения access_token. При формировании платежного поручения вы передаете с другими атрибутами access_token, по которому Банк самостоятельно в платежное поручение подставляет все реквизиты плательщика (отправителя).

Где взять access_token?

Получение access_token необходимо реализовать в рамках сервиса СберБизнес ID.

Что будет, если Клиент покинет страницу оплаты, не подписав черновик платежного поручения?

При использовании ресурсов "Моментальные платежи", которые создают черновики платежных поручений, черновики также появляются в СберБизнес Клиента. Любой пользователь Клиента, который имеет право подписи черновиков платежных поручений, сможет подписать черновик.

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