Переводы c бизнес-карт
Переводы на карты Сбера или другие карты банков-эмитентов РФ, а также на банковские счета.
Обзор продукта
Общий перечень и порядок использования ресурсов 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 Получите ключ шифрования1 | GET /fintech/api/v2/corporate-cards/transfer/public-key | CORPORATE_CARDS |
4 Создайте заявление на перевод и получите размер комиссии2 | POST /fintech/api/v2/сorporate-cards/transfer/commission | BUSINESS_CARDS_TRANSFER |
5 Подпишите заявление на перевод | POST /fintech/api/v2/corporate-cards/sign-and-approve | BUSINESS_CARDS_TRANSFER |
6 Получите статус заявления на перевод | GET /fintech/api/v2/сorporate-cards/transfer/{externalId}/status | BUSINESS_CARDS_TRANSFER |
7 Получение списка заявлений на перевод со статусами переводов | /fintech/api/v2/сorporate-cards/transfer/list | BUSINESS_CARDS_TRANSFER |
Участники, условия и результат
Участники Пользователь – сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа), Платформа – любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи, Sber API – запросы и ресурсы Sber API, к которым обращается Платформа.
Предварительные условия Пользователь: имеет профиль в СберБизнес своей компании и прошел авторизацию.
ERP-cистема:
имеет функциональности хранения индентификаторов активных бизнес-карт,
ввода реквизитов перевода, подтверждения согласия с условиями перевода (отображение комиссии),
создания ЭЦП к документу,
информирования о создании заявления,
отображения списка заявлений и статусов перевода.
Результат Заявление на перевод по бизнес-карте создано и подписано, Отображаются список заявлений и статусы переводов.
UML-диаграммы
В этом варианте применения можно использовать подписание документа при помощи API-запроса. ЭЦП должна принадлежать сотруднику вашей компании. Подробнее....
При помощи платформы
Под платформой в данном разделе понимаем любую информационную систему партнера, предназначенную для предоставления финтех-услуг Сбера, отличную от ERP. Интеграция с помощью платформы отличается возможностью реализовать альтернативный сценарий подписания заявления на перевод – переадресация пользователя на страницу черновика заявления в СберБизнес с последующим возвратом на Платформу.
Шаг | Запросы SberAPI | Код операции в scope |
---|---|---|
1 Получите токен доступа | POST /ic/sso/api/v2/oauth/token | openid |
2 Получите информацию по бизнес-картам | POST /fintech/api/v2/corporate-cards/list | CORPORATE_CARDS |
3 Получите ключ шифрования1 | GET /fintech/api/v2/corporate-cards/transfer/public-key | CORPORATE_CARDS |
4 Создайте заявление на перевод и получите размер комиссии2 | POST /fintech/api/v2/сorporate-cards/transfer/commission | BUSINESS_CARDS_TRANSFER |
5 Подпишите заявление на перевод3 | POST /fintech/api/v2/corporate-cards/sign-and-approve | BUSINESS_CARDS_TRANSFER |
6 Получите статус заявления на перевод | GET /fintech/api/v2/сorporate-cards/transfer/{externalId}/status | BUSINESS_CARDS_TRANSFER |
7 Получение списка заявлений на перевод со статусами переводов | /fintech/api/v2/сorporate-cards/transfer/list | BUSINESS_CARDS_TRANSFER |
Переадресация на заявление на перевод
При создании заявления на перевод с помощью запроса API, он также отображается в интерфейсе СберБизнес. Пользователь имеет возможность подписать завяление в таком интерфейсе самостоятельно. Для открытия интерфейса СберБизнес нужно сформировать ссылку и переадресовать по ней пользователя. После аутентификации и успешного подписания, сервис вернет Пользователя на вашу платформу.
- Пример ссылки
- Модель ссылки
https://sbi.sberbank.ru:9443/ic/ufs/corporate-cards/index.html#/transfer-creator/d4fbfe27-ee37-4451-b224-8113a06c44a3?backUrl=https://www.example.ru/
{контур Банка}/ic/ufs/corporate-cards/index.html#/transfer-creator/{externalid}?backUrl={backUrl}
Переменная | Описание | Дополнительная информация |
---|---|---|
{контур Банка} | адрес Банка, на который делается запрос для открытия страницы сервиса оплаты | - Тестовый контур https://efs-sbbol-ift-web.testsbi.sberbank.ru:9443 - Промышленный контур СМС-пользователь https://sbi.sberbank.ru:9443 |
{externalid} | уникальный идентификатор платежного документа | Данный идентификатор присваивает ваша Платформа на шаге создания черновика платежного поручения |
{backUrl} | страница возврата, на которую Банк вернет пользователя Клиента после успешного подписания черновика платежного поручения | - backUrl нужно закодировать URLEncode; - Если не указать backUrl в ссылке, пользователи не смогут после подписания платежного поручения вернуться на Платформу; - Если backUrl будет отличаться от адреса вашей платформы, который указали при регистрации в Банке, то при возврате клиента на backUrl он будет видеть ошибку. |
Участники, условия и результат
Участники
Пользователь – сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа), Платформа – любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи, Sber API – запросы и ресурсы Sber API, к которым обращается Платформа.
Предварительные условия
Пользователь: имеет профиль в СберБизнес своей компании и прошел авторизацию.
Платформа имеет функциональности:
хранения индентификаторов активных бизнес-карт,
ввода реквизитов перевода, подтверждения согласия с условиями перевода (отображение комиссии),
передаресации пользователя на страницу подписания заявления в Сбербизнес,
информирования о создании заявления,
отображения списка заявлений и статусов перевода.
Результат
Заявление на перевод по бизнес-карте создано и подписано, Отображаются список заявлений и статусы переводов.
UML-диаграммы
В схеме можно использовать автоматизированное подписание документа. Данная возможность доступна только при использовании ЭЦП сотрудника вашей компании.
Подробнее об использовании ЭЦП в Sber API можно почитать в одноименном разделе.
Дайджест перевода
- Пример
- Формат
Дайджест ERP-перевода по номеру карты:
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
receiverInfo.encryptedCardNumber=GK1rG0H+ULhAvi8wjkZUIY+ymA/WmmItbrWm1xY0Lbb44bXzw+uO7qU1MaN0/IM1eQ6MmehnX608J6NExJwmheRofwT8aZG7sVg6PQADvpPcMhGUPBOPe4KcMD/rR04/BxA/EB0c/mooLPPRu9NYyuEfIvZCXhXxSSEklpsOOyN7oPYnUC2X7/Ec+8eRmaSEA7l6r+ObDnrQKwpKFqHgTzihuInic+g8oHbR4K3ksS+KwCbPPokyGItahMWnAoRYX2oeRBg7Fvbn+r0aaUVU+eJC2wUqkhdkVjvkk6sijPrcKiK+DRBBxYK66LVGGrqEaROU/wzBwOGKHpw3JFtXwQ==
receiverInfo.lastName=И.
receiverInfo.firstName=ИВАН
receiverInfo.middleName=ИВАНОВИЧ
receiverInfo.bankName=Сбербанк
receiverInfo.organizationName=ПАО ВСПЫШКА
Дайджест ERP-перевода по номеру телефона:
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
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 |
receiverInfo | ||
encryptedCardNumber | Зашифрованный номер карты получателя (указывается, если перевод по номеру карты) | HlaeIHXXEcGT1bFxo1NlpAzpr+kJ2IQrcxVdvDTep |
phoneNumber | Номер телефона получателя (указывается, если перевод по номеру телефона) | 79880098877 |
lastName | Фамилия получателя | И. |
firstName | Имя получателя | ИВАН |
lastName | Отчество получателя | ИВАНОВИЧ |
bankName | Банк получателя перевода | Сбербанк |
organizationName | Организация получателя | ПАО ВСПЫШКА |
- Нужен для шифрования номера карты получателя. ↩
- Перевод с бизнес-карты Сбера юридическому лицу (кроме СБП-переводов) осуществляется только с указанием номера карты получателя (любая карта ПАО Сбербанк и других банков-эмитентов РФ). Переводы с бизнес-карт Сбера физическому лицу могут осуществляться также c указанием номера телефона получателя (указание номера карты в данном случае запрещено).↩
- Или реализуйте сценарий с переадресацией. ↩