ym88659208ym87991671
Выплата на счет или карту Сбера | Документация для разработчиков

Выплата на счет или карту Сбера

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

Откройте счет или выпустите карту Сбера, чтобы перечислять зарплату сотрудникам на них.

Обзор продукта

Общий перечень и порядок использования ресурсов SberAPI, относящихся к функциональности продукта.

Порядок использования

Перечень ресурсов

Используемые ресурсы SberAPIОписание
/ic/sso/api/v2/oauth/token1. Авторизация пользователя.
Токен доступа понадобится при обращении к API-запросам. Подробнее в разделе СберБизнес ID.
/fintech/api/v1/salary-agreements2. Работа с зарплатными договорами:
- получение информации о зарплатных договорах (потребуется при создании заявления на выплату).
/fintech/api/v1/client-info2. Работа с информацией о компании:
- получение информации о компании.
/fintech/api/v1/dicts2. Работа со справочниками:
- получение справочной информации.
/fintech/api/v1/card-issues3. Управление открытием счетов и выпуском карт (реестром) 1:
- подача заявления на открытие счетов и выпуск карт (создание реестра),
- получение статуса реестра,
- получение деталей реестра.
/fintech/api/v1/payrolls4. Работа с выплатой по зарплатному проекту (зарплатной ведомостью)2:
- подача заявления на выплату (создание ведомости),
- получение статуса ведомости,
- получение деталей ведомости.

Варианты применения

Примеры состава и порядка исполнения запросов SberAPI в разных вариантах применения. Состав запросов может отличаться в зависимости от ваших бизнес-задач.

Выплата со счета в Сбере

ШагЗапросы SberAPIКод операции в scope
1 Получите токен доступаPOST /ic/sso/api/v2/oauth/tokenopenid
2 Получите информацию по зарплатному договоруGET /fintech/api/v1/salary-agreementsSALARY_AGREEMENT
3 Получите информацию о компанииGET /fintech/api/v1/client-infoGET_CLIENT_ACCOUNTS
4 Получите информацию по типам пластиковых карт1GET /fintech/api/v1/dicts?name=MzpCardTypeDICT
5 Создайте реестр на открытие счетов и выпуск карт2GET /fintech/api/v1/card-issues/CARD_ISSUE
6 Создайте зарплатную ведомостьPOST /fintech/api/v1/payrollsPAYROLL
7 Получите статус зарплатной ведомостиGET /fintech/api/v1/payrolls/{externalId}/statePAYROLL
8 Получите детали зарплатной ведомостиGET /fintech/api/v1/payrolls/{externalId}PAYROLL
Участники, условия и результат

Участники

  • Пользователь – сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа),
  • Платформа – любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи,
  • Sber API – запросы и ресурсы Sber API, к которым обращается Платформа.

Предварительные условия

Пользователь:

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

Результат

  • Создан и подписан платежный документ.
UML-диаграмма

В этом варианте применения можно использовать подписание документа при помощи API-запроса. ЭЦП должна принадлежать сотруднику вашей компании. Подробнее...

Выплата со счета в Сбере

При помощи платформы

Под платформой в данном разделе понимаем любую информационную систему партнера, предназначенную для предоставления финтех-услуг Сбера, отличную от ERP. Интеграция с помощью платформы отличается возможностью реализовать альтернативный сценарий подписания зарплатного реестра – переадресация пользователя на страницу зарплатного реестра в СберБизнес с последующим возвратом на Платформу.

ШагЗапросScope
1. Получите токен доступаPOST /ic/sso/api/v2/oauth/tokenopenid
2. Получите информацию по зарплатному договоруGET /fintech/api/v1/salary-agreementsSALARY_AGREEMENT
3. Получите информацию о счетах компанииGET /fintech/api/v1/client-infoGET_CLIENT_ACCOUNTS
4. Создайте зарплатную ведомостьPOST /fintech/api/v1/payrollsPAYROLL
5. Получите статус зарплатной ведомостиGET /fintech/api/v1/payrolls/{externalId}/statePAYROLL
6. Получите детали зарплатной ведомостиGET /fintech/api/v1/payrolls/{externalId}PAYROLL
Участники, условия и результат

Участники

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках вашего сервиса (Платформа)
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа
  • Сбербизнес - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа
  • Сторонний банк - любой другой банк, где у компании Пользователя есть расчетный счет

Предварительные условия

Пользователь:

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

Результат

  • Создан и подписан зарплатный реестр
UML

Переадресация на зарплатный реестр

Для начала обработки зарплатного реестра Банком он должен быть подписан. При создании документа с помощью запроса API, документ также появляется в клиентской части СберБизнес Пользователя.

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

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

{контур Банка}/ic/ufs/payroll-light/index.html#/payroll-sign-and-send/{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 он будет видеть ошибку.

Схема работы с переадресацией в СББОЛ

sbbapi-payroll-light.png
Клиентский путь
ШагДействияСкрин
1Пользователь выбрал интересующий продукт и перешел к оплате.
Вы предлагаете авторизоваться с помощью СберБизнес ID.
sbbapi-case-1.png
2Нажал на "Войти по СберБизнес ID" и попал на станицу аутентификации.
sbbapi-case-2.png
3После успешной аутентификации СберБизнес ID отображает данные по реестру и предлагает подписать его.
Важно! Платформа ранее создала зарплатный реестр.
sbbapi-salary-light-1.png

sbbapi-salary-light-2.png
4Пользователь направил зарплатный реестр в банк после успешного подписания.
sbbapi-salary-light-3.png
5Пользователь получил статус отправленного зарплатного реестра.
sbbapi-salary-light-4.png

Footnotes

  1. Чтобы Сбер мог начать обрабатывать платежный документ сразу, он должен быть подписан электронной подписью уполномоченного сотрудника (имеющего право подписи от лица компании). Владелец токена доступа пользователя вашей компании должен совпадать с владельцем ЭП, которую будете использовать для подписания ведомости. Подробнее о работе с электронной подписью. 2

  2. В случае, если хотите открыть зарплатный счет или карту в Сбере. 2

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