Сервис «Моментальные платежи»
Информация о сервисе
Моментальные платежи – это сервис для организации расчетов между юридическими лицами (ЮЛ) и индивидуальными предпринимателями (ИП), который позволяет формировать и отслеживать статус платежного документа в СберБизнес плательщика.
Ядро механизма сервиса составляют платежные поручения, которые используются в качестве платежных документов для расчетов между компаниями.
Платежное поручение
Платежное поручение – это документ, который используется для указания банку перевести определенную сумму денег с одного счета на другой. Обычно это делается, когда компания хочет произвести оплату за товары или услуги, перевести деньги индивидуальному предпринимателю или юридическому лицу.
Платежные поручения используются широким кругом лиц, включая индивидуальных предпринимателей, малый и средний бизнес, крупные корпорации и даже государственные учреждения. Их используют, когда нужно сделать перевод, который требует предварительного уведомления или планирования (например, оплата аренды, коммунальных услуг или выплата заработной платы).
До начала разработки интеграции с сервисом потребуется:
- Заключить договор с Банком на использование сервиса "Моментальные платежи".
- Завершить интеграцию со СберБизнес ID.
Без сервиса СберБизнес ID настроить работу "Моментальные платежи" невозможно.
Схема работы сервиса
- Графическое описание
- Текстовое описание
| Шаг | Что делаем | Подробности |
|---|---|---|
| 1 | Авторизуйте Пользователя с помощью СберБизнес ID | Подробно о подключении и работе сервиса СберБизнес ID рассказали в соответствующем разделе документации. |
| 2 | Создайте платежное поручение в СберБизнес Пользователя | С помощью одного из предложенных ниже POST-запросов и access_token Пользователя Клиента вы создатите черновик платежного поручения в СберБизнес Клиента. Для создания черновика платежного документа выберете запрос, который подходит под ваши задачи: /fintech/api/v1/payments/from-invoice — для получения денежных средств на счет вашей компании в Сбербанке./fintech/api/v1/payments/from-invoice-any — для организации переводов, где отправитель — любая компания со счетом в Сбербанке, а получатель — любая компания со счетом в любом банке./fintech/api/v1/payments/from-invoice-budget — для разработки функциональности по оплате налоговых, таможенных и других бюджетных платежей. |
| 3 | Переадресуйте Пользователя на страницу подписания документа | С использованием идентификатора созданного черновика платежного поручения из шага №2 вы формируете ссылку для оплаты и перенаправляете по ней пользователя Клиента. Перейдя по ссылке в сервис оплаты, пользователь пройдет аутентификацию, выберет счет списания и подпишет черновик платежного поручения для исполнения Банком. Ссылка переадресации выглядит следующим образом: {контур Банка}/ic/dcb/index.html#/payment-creator/{externalid}?backUrl={backUrl}Дополнительная информация о формировании ссылки. |
| 4 | Проверьте статус и корректность оплаты | С помощью запроса /fintech/api/v1/payments/{externalId}/state вы сможете разработать механизм проверки статуса оплаты и реакцию Платформы на каждый из них.С помощью запроса /fintech/api/v1/payments/{externalId} вы сможете получить все параметры ранее созданного платежного поручения. Эту информацию можно использовать, например, в механизме проверки корректности платежа. |
Клиентский путь
Глазами Пользователя
| Шаг | Действия | Скрин |
|---|---|---|
| 1 | Пользователь выбрал интересующий продукт и перешел к оплате. Вы предлагаете авторизоваться с помощью СберБизнес ID. |  |
| 2 | Нажал на "Войти по СберБизнес ID" и попал на станицу аутентификации. |  |
| 3 | После успешной аутентификации СберБизнес ID предлагает подписать Согласие. |  < br />  |
| 4 | Платформа создала платежное поручение и переадресовала Пользователя на него. |  |
| 5 | Пользователь выбрал счет списания и подписал платежное поручение. |  |
Варианты реализации
Ниже будут приведены примеры реализации. Сценарии могут быть для вас отправной точкой и идеей для финального способа реализации функциональности.
Сценарии описали общие, для более легкого восприятия информации описания работы с сервисом «Моментальные платежи».
Можно использовать разные триггеры запуска того или иного сценария - действия пользователя, регламентный запуск по времени, наступление определенных соб ытий и другие варианты.
Оплата на счет вашей компании в Сбербанке
Подойдет для получения денежных средств на счет вашей компании в Сбербанке
Шаги
- Получить реквизиты перевода
- Создать платежное поручение
- Подписать платежное поручение
Участники usecase
- Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках Платформы
- Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
- Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа
Предусловия
- Пользователь имеет пользовательский профиль в СберБизнес своей компании
- Пользователь находится в пространстве Платформы
- Пользователь прошел авторизацию с помощью СберБизнес ID
Постусловия
- Подписано платежное поручение для оплаты ваших товаров/услуг
Используемые запросы
| № | Метод | Точка вызова | Описание | Операция в scope | Шаг в схеме |
|---|---|---|---|---|---|
| 1 |  | /fintech/api/v1/client-info | Получение расширенной информации | GET_CLIENT_ACCOUNTS | 1. Получить реквизиты перевода |
| 2 |  | /ic/sso/api/v2/oauth/token | Обновление токена доступа | openid | 1. Получить реквизиты перевода |
| 3 | | /fintech/api/v1/payments/from-invoice | Создать черновик платежного поручения (отправка на свой счет в Сбербанке) | PAY_DOC_RU_INVOICE | 2. Создать платежное поручение |
Расчеты B2B
Подойдет для организации переводов, где отправитель — любая компания со счетом в Сбербанке, а получатель — любая компания со счетом в любом банке.
Шаги
- Получить реквизиты перевода
- Создать платежное поручение
- Подписать платежное поручение
Участники usecase
- Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках Платформы
- Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
- Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа
Предусловия
- Пользователь имеет пользовательский профиль в СберБизнес своей компании
- Пользователь находится в пространстве Платформы
- Пользователь прошел авторизацию с помощью СберБизнес ID
Постусловия
- Проведена оплата за товары/услуги на счет вашей или сторонней компании.
Используемые запросы
| № | Метод | Точка вызова | Описание | Операция в scope | Шаг в схеме |
|---|---|---|---|---|---|
| 1 | | /fintech/api/v1/client-info | Получение расширенной информации | GET_CLIENT_ACCOUNTS | 1. Получить реквизиты перевода |
| 2 | | /ic/sso/api/v2/oauth/token | Обновление токена доступа | openid | 1. Получить реквизиты перевода |
| 3 | | /fintech/api/v1/payments/from-invoice-any | Создать черновик платежного поручения (отправка в любой банк) | PAY_DOC_RU_INVOICE_ANY | 2. Создать платежное поручение |
Платежи в бюджет
Подойдет для разработки функциональности по оплате налоговых, таможенных и других бюджетных платежей.
Шаги
- Получить реквизиты перевода
- Создать платежное поручение
- Подписать платежное поручение
Участники usecase
- Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках Платформы
- Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую исп ользуют Пользователи
- Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа
Предусловия
- Пользователь имеет пользовательский профиль в СберБизнес своей компании
- Пользователь находится в пространстве Платформы
- Пользователь прошел авторизацию с помощью СберБизнес ID
Постусловия
- Проведена оплата в пользу бюджетной компании
Используемые запросы
| № | Метод | Точка вызова | Описание | Операция в scope | Шаг в схеме |
|---|---|---|---|---|---|
| 1 | | /fintech/api/v1/client-info | Получение расширенной информации | GET_CLIENT_ACCOUNTS | 1. Получить реквизиты перевода |
| 2 | | /ic/sso/api/v2/oauth/token | Обновление токена доступа | openid | 1. Получить реквизиты перевода |
| 3 | | /fintech/api/v1/payments/from-invoice-budget | Создать черновик платежного поручения (отправка в бюджет) | PAY_DOC_RU_INVOICE_BUDGET | 2. Создать платежное поручение |
Проверка статуса и корректности оплаты
Время начала и частоту проверки статуса и корректности оплаты вы определяете самостоятельно исходя из своих бизнес-задач.
Шаги
- Получить статус оплаты
- Проверить корректность
Участники usecase
- Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
- Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа
Предусловия
- Успешно выполнен сценарий "Оплата на счет вашей компании в Сбербанке" или "Расчеты B2B" или "Платежи в бюджет"
- Платформа сохранила идентификатор (extertalId) платежного поручения, созданного в одного из сценариев выше
Постусловия
- Платежное поручение исполнено
- Проверена корректность проведенной оплаты
| № | Метод | Точка вызова | Описание | Операция в scope | Шаг в схеме |
|---|---|---|---|---|---|
| 1 | | /fintech/api/v1/payments/{externalId}/state | Получение статуса рублевого платежного поручения | PAY_DOC_RU_INVOICE или PAY_DOC_RU_INVOICE_ANY или PAY_DOC_RU_INVOICE_BUDGET | 1. Получить статус оплаты |
| 2 | | /ic/sso/api/v2/oauth/token | Обновление токена доступа | openid | 1. Получить статус оплаты |
| 3 | | /fintech/api/v1/payments/{externalId} | Получение платежного поручения | PAY_DOC_RU_INVOICE или PAY_DOC_RU_INVOICE_ANY или PAY_DOC_RU_INVOICE_BUDGET | 2. Проверить корректность |
Переадресация на платежное поручение
Для начала обработки платежного поручения Банком оно должно быть подписано. При создании документа с помощью запроса API, документ также появляется в клиентской части СберБизнес Пользователя.
Можно облегчить пользовательский сценарий, если Пользователю сразу открыть упрощенный интерфейс СберБизнес только с данными платежного документа. Для открытия упрощенного интерфейса СберБизнес потребуется сформировать ссылку и переадресовать по ней пользователя. Перейдя по ссылке на страницу платежного поручения, Пользователь пройдет аутентификацию, выберет счет списания и подпишет документ. При успешном подписании сервис вернет Пользователя на вашу Платформу.
- Модель ссылки
- Пример
Ссылка переадресации выглядит следующим образом:
{контур Банка}/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 он будет видеть ошибку. |
https://sbi.sberbank.ru:9443/ic/ufs/rpp-light/index.html#/payment-creator/d4fbfe27-ee37-4451-b224-8113a06c44a3?backUrl=https://www.example.ru/
Дополнительная информация
Назначение платежа
Назначение должно раскрывать экономический смысл платежа.
- Сведения должны быть лаконичными — у поля есть ограничения по знакам 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
Какой максимальный срок жизни можно установить для платежного поручения?
Пунктами 5.5, 7.7, 9.6 Положения 383-П установлено, что платежные поручения, инкассовые поручения, платежные требования действительны для представления в банк в течение 10 календарных дней со дня их составления, то есть исчисление срока начинается на следующий день после их составления.
Дата истечения заказа устанавливается в соответствие с вашими бизнес-задачами вами атрибутом 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.
Что будет, если Клиент покинет страницу оплаты, не подписав черновик платежного поручения?
При использовании ресурсов "Моментальные платежи", которые создают черновики платежных поручений, черновики также появляются в СберБизнес Клиента. Любой пользователь Клиента, который имеет право подписи черновиков платежных поручений, сможет подписать черновик.