Управление общими лимитами бизнес-карт: установка лимитов и получение информации по лимитам с доступным остатком по бизнес-карте.
Обзор продукта
Общий перечень и порядок использования ресурсов Sber API, относящихся к функциональности продукта.
Порядок использования
Перечень ресурсов
| Используемые ресурсы SberAPI | Описание |
|---|---|
| /ic/sso/api/v2/oauth/token | Авторизация пользователя. Токен доступа понадобится при обращении к API-запросам. Подробнее в разделе СберБизнес ID. |
| /fintech/api/v2/corporate-cards/list | Получение списка бизнес-карт. Понадобится при работе с функциональностью лимитов. |
| /fintech/api/v2/corporate-cards/limits/create-or-update | Создание черновика заявки на общие лимиты. |
| /fintech/api/v2/corporate-cards/sign-and-approve | Подписание заявки на лимиты. |
| /fintech/api/v2/corporate-cards/limits/get | Получение списка установленных лимитов по бизнес-карте. |
Варианты применения
Общие примеры состава и порядка исполнения запросов Sber API. Состав и порядок запросов может отличаться в зависимости от ваших бизнес-задач.
Установка и получение лимитов через Платформу
Под платформой в данном разделе понимаем любую информационную систему партнера, предназначенную для предоставления финтех-услуг Сбера.
| Шаг | Запросы SberAPI | Код операции в scope |
|---|---|---|
| 1 Получите токен доступа | POST /ic/sso/api/v2/oauth/token | openid |
| 2 Получите информацию по бизнес-картам | POST /fintech/api/v2/corporate-cards/list | CORPORATE_CARDS |
| 3 Создайте черновик заявки на общие лимиты | POST /fintech/api/v2/corporate-cards/limits/create-or-update | CORPORATE_CARDS |
| 4 Подпишите заявку на лимиты | POST /fintech/api/v2/corporate-cards/sign-and-approve | CORPORATE_CARDS |
| 5 Получите список установленных лимитов | POST /fintech/api/v2/corporate-cards/limits/get | CORPORATE_CARDS |
Участники
Пользователь – сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа), Платформа – любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи, Sber API – запросы и ресурсы Sber API, к которым обращается Платформа.
Предварительные условия
Пользователь: имеет профиль в СберБизнес своей компании и прошел авторизацию.
Платформа имеет функциональности:
- хранения индентификаторов активных бизнес-карт,
- ввода значений лимитов,
- информирования о создании заявки,
- отображения информации по лимитам.
Результат
Заявка на установку общих лимитов создана и подписана. Отображается информация по лимитам.
В схеме можно использовать автоматизированное подписание документа. Данная возможность доступна только при использовании ЭП сотрудника вашей компании.
Подробнее об использовании ЭП в Sber API можно почитать в одноименном разделе.
Дайджест заявки на лимиты
Формирование дайджеста должно полностью соответствовать ответу на изменение лимитов: включать только присутствующие поля и значения, сохраняя их исходные типы данных и точный порядок из примера ниже. Любые отклонения приведут к ошибке подписи.
externalId = 4ae05108-fe94-4bb8-b95a-3da9bc9cf98e
businessCardId = 1d612630-824f-46dc-a807-5a3746ba7cac
cashLimits.day = 20001
cashLimits.month = 2000001
transferLimits.day = 1001
transferLimits.month = 100001
nonCashLimit.day.value = 1000001
nonCashLimit.day.activation = true
totalLimits.month.value = 3000001
totalLimits.month.activation = true
totalLimits.period.value = 131313
totalLimits.period.activation = true
totalLimits.period.endDate = 2026-06-19T23:59:59.999Z
totalLimits.period.blockOperationsAfterPeriod = false
| Наименование поля | Описание поля | Пример |
|---|---|---|
| externalId | Внешний идентификатор заявки | 4ae05108-fe94-4bb8-b95a-3da9bc9cf98e |
| businessCardId | Идентификатор бизнес-карты | 1d612630-824f-46dc-a807-5a3746ba7cac |
| cashLimits | ||
| day | Дневной лимит | 20001 |
| month | Месячный лимит | 2000001 |
| transferLimits | ||
| day | Дневной лимит | 1001 |
| month | Месячный лимит | 100001 |
| nonCashLimit | ||
| day | Лимит на безналичные операции | |
| value | Установленная сумма лимита | 1000001 |
| activation | Активация/Деактивация лимита | true |
| totalLimits | Общие лимиты | |
| month | Месячный лимит | |
| value | Сумма лимита | 3000001 |
| activation | Активация/Деактивация лимита | true |
| period | Лимит на период | |
| value | Сумма лими та | 131313 |
| activation | Активация/Деактивация лимита | true |
| endDate | Дата окончания действия лимита | 2026-06-19T23:59:59.999Z |
| blockOperationsAfterPeriod | Запрет операций по истечению периода | false |