СБП-переводы
Переводы по системе быстрых платежей на карты Сбера или другие карты банков-эмитентов РФ, а также на банковские счета.
Обзор продукта
Общий перечень и порядок использования ресурсов SberAPI, относящихся к функциональности продукта.
Порядок использования
Перечень ресурсов
| Используемые ресурсы SberAPI | Описание |
|---|---|
| /ic/sso/api/v2/oauth/token | Авторизация пользователя. Токен доступа понадобится при обращении к API-запросам. Подробнее в разделе СберБизнес ID. |
| /fintech/api/v2/corporate-cards/list | Получение списка бизнес-карт. Понадобится при работе с функциональностью переводов. |
| /fintech/api/v2/corporate-cards/transfer | Работа с функциональностью СБП-переводов: - получение списка банков, поддерживающих СБП, - создание заявления на перевод по СБП и получение размера комиссии, - получение статуса заявления (в разработке), - получение списка заявлений (в разработке). |
| /fintech/api/v2/corporate-cards/sign-and-approve | Подписание заявления на перевод. |
Варианты применения
Общие примеры состава и порядка исполнения запросов SberAPI. Состав и порядок запросов может отличаться в зависимости от ваших бизнес-задач.
При помощи ERP-системы
Функциональность проверки статуса и корректности перевода по СБП еще в разработке.
| Шаг | Запросы SberAPI | Код операции в scope |
|---|---|---|
| 1 Получите токен доступа | POST /ic/sso/api/v2/oauth/token | openid |
| 2 Получите информацию по бизнес-картам | POST /fintech/api/v2/corporate-cards/list | CORPORATE_CARDS |
| 3 Получите список банков, поддерживающих СБП | GET /fintech/api/v2/corporate-cards/sbp-transfer/bank | BUSINESS_CARDS_TRANSFER |
| 4 Создайте заявление на перевод по СБП и получите размер комиссии1 | POST /fintech/api/v2/сorporate-cards/sbr-transfer/commission | BUSINESS_CARDS_TRANSFER |
| 5 Подпишите заявление на перевод | POST /fintech/api/v2/corporate-cards/sign-and-approve | BUSINESS_CARDS_TRANSFER |
Участники, условия и результат
Участники
Пользователь – сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа), Платформа – любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи, Sber API – запросы и ресурсы Sber API, к которым обращается Платформа.
Предварительные условия
Пользователь: имеет профиль в СберБизнес своей компании и прошел авторизацию.
ERP-cистема:
имеет функциональности хранения индентификаторов активных бизнес-карт,
ввода реквизитов перевода, подтверждения согласия с условиями перевода (отображение комиссии),
создания ЭЦП к документу,
информирования о создании заявления,
отображения списка заявлений и статусов перевода.
Результат
Заявление на перевод по СБП создано и подписано.
UML-диаграммы
В этом варианте применения можно использовать подписание документа при помощи API-запроса. ЭЦП должна принадлежать сотруднику вашей компании. Подробнее....
Дайджест для СБП переводов
- Пример
- Формат
Дайджест СБП перевода:
externalId=607e9b20-ff6b-4e1a-1111-af12d56caa60
transferPurpose=За товар по договору №2 от 12/01/2024
transferAmount.amount=1000.00
transferAmount.сurrency=RUR
transferCommission.amount=10.00
transferCommission.сurrency=RUR
senderInfo.businessCardId=c114a123-44f5-4fc5-8a79-cbb09f40ca8b
senderInfo.account=40817810990000000000
receiverInfo.phoneNumber=79880098877
receiverInfo.lastName=И.
receiverInfo.firstName=ИВАН
receiverInfo.middleName=ИВАНОВИЧ
receiverInfo.bankName=Сбербанк
receiverInfo.organizationName=ПАО ВСПЫШКА
| Наименование поля | Описание поля | Пример |
|---|---|---|
| externalId | Внешний идентификатор документа | f8ad3141-b7e8-4924-92de-3de4fd0a464e |
| transferPurpose | Назначение перевода | Иванов Иван Ильич, 1234 987654; ПСА №123 от 01.01.2020; лом стальной, 123 кг, 15000 руб./т.; без НДС |
| transferAmount | ||
| amount | Размер перевода | 25.00 |
| сurrency | Валюта перевода | RUR |
| transferCommission | ||
| commission | Размер комиссии | 2.00 |
| сurrency | Валюта комиссии | RUR |
| senderInfo | ||
| senderBusinessCardId | ID карты отправителя бизнес-карты | 31663ef5-7975-4016-b0f3-f1d70a4e9c22 |
| account | Счет бизнес-карты отправителя | 40817810990000000000 |
| receiverInfo | ||
| phoneNumber | Номер телефона получателя | 79880098877 |
| lastName | Фамилия получателя | И. |
| firstName | Имя получателя | ИВАН |
| lastName | Отчество получателя | ИВАНОВИЧ |
| bankName | Банк получателя перевода | Сбербанк |
| organizationName | Организация получателя | ПАО ВСПЫШКА |
- Перевод будет выполнен по номеру телефона.↩