Сценарии интеграции

Обновлено 30 сентября 2026

Сервис «Сразу» поддерживает два типовых сценария интеграции. Оба используют один и тот же набор запросов; разница лишь в том, от имени кого создается заказ и чей токен передается в заголовке Authorization.

Критерий	Сценарий 1. H2H	Сценарий 2. B2BSaaS
Кто интегрирует	Компания с собственной CRM или учетной системой	Облачный сервис для бизнеса (маркетплейс, SaaS, казначейская система, мультибанк)
Получатель средств	Сама интегрирующая компания (владелец client_id)	Пользователи платформы (продавцы)
Плательщик	Контрагенты интегрирующей компании	Контрагенты пользователей платформы
Токен в Authorization	Токен своей компании (из ЛК Sber API)	Токен продавца (через СберБизнес ID)
Интеграция со СберБизнес ID	Не требуется	Обязательна (авторизация каждого продавца)

Сценарий 1. H2H — прием оплат собственной компанией

Компания интегрирует «Сразу» в свою CRM или учетную систему, чтобы принимать оплаты от своих контрагентов. Деньги поступают на счет самой компании — владельца client_id. Интеграция со СберБизнес ID не требуется: пару access/refresh токенов на свою компанию получают в личном кабинете Sber API и далее только обновляют их.

Последовательность действий:

1. Получите в ЛК Sber API пару access/refresh токенов своей компании и настройте на своей стороне автоматическое обновление токена.
2. Создайте заказ: POST /v1/sberbusinesspay/orders, передав в Authorization токен своей компании, а в теле — суммы (sum, totalSum, vatSum), наименование сервиса (serviceName), состав позиций (positions), externalId, externalNumber, при необходимости payeeAccount и expirationTime.
3. Получите ссылку на заказ: в ответе 201 Created сервис вернет тело заказа и готовую ссылку в поле url.
4. При необходимости дополните ссылку параметром backUrl (значение — URLEncode), чтобы вернуть плательщика на ваш сайт после оплаты (см. раздел 5).
5. Передайте ссылку плательщику любым способом: редирект или кнопка на сайте, email, мессенджер, QR-код в офлайн-точке.
6. Плательщик открывает ссылку и оплачивает заказ удобным способом (клиентский путь описан в разделе 3).
7. Опрашивайте статус заказа: GET /v1/sberbusinesspay/orders/{externalId}/state. Частоту опроса выбирайте согласно рекомендациям в разделе «Статусы заказа».
8. При необходимости получите полную информацию по заказу: GET /v1/sberbusinesspay/orders/{externalId} — для сверки сумм и позиций, реквизитов получателя и закрытия сделки в своей системе.

Результат: оплата поступила на счет компании, сделка закрыта в CRM/учетной системе автоматически.

Сценарий 2. B2BSaaS — прием оплат от имени пользователей платформы

Платформа (маркетплейс, облачный сервис для бизнеса, казначейская или мультибанковская система) интегрирует «Сразу» один раз и дает своим пользователям-продавцам возможность принимать оплаты от их контрагентов. Заказ создается от имени продавца: в заголовке Authorization передается токен продавца, полученный через СберБизнес ID.

Ключевое правило: владелец токена в Authorization и получатель средств в теле запроса должны совпадать. Если компания-владелец токена отличается от компании-владельца реквизитов в теле — сервис вернет 400 Bad Request. Поэтому платформе необходимо авторизовать каждого подключаемого продавца через СберБизнес ID и хранить его токены; токен самой платформы (client credentials) для создания заказов от имени продавцов не подходит.

Последовательность действий:

1. Реализуйте на платформе авторизацию пользователя-продавца через СберБизнес ID (поток authorization code): получите его access/refresh токены, храните и автоматически обновляйте их.
2. Продавец формирует в интерфейсе платформы заказ своему клиенту (плательщику).
3. Создайте заказ: POST /v1/sberbusinesspay/orders, передав в Authorization токен продавца, а в теле — суммы, состав позиций, externalId, externalNumber и payeeAccount продавца.
4. Дождитесь результата сверки: при совпадении владельца токена и получателя сервис вернет 201 Created со ссылкой url; при несовпадении — 400 Bad Request.
5. При необходимости дополните ссылку параметром backUrl (значение — URLEncode).
6. Передайте ссылку плательщику способом, который определен реализацией платформы: кнопка «Оплатить Сразу» на сайте, QR-код, отправка ссылки по email/SMS и другие варианты.
7. Плательщик открывает ссылку и оплачивает заказ удобным способом (клиентский путь описан в разделе 3).
8. Опрашивайте статус заказа: GET /v1/sberbusinesspay/orders/{externalId}/state, передавая в Authorization токен продавца. Частоту опроса выбирайте согласно рекомендациям в разделе «Статусы заказа».
9. При необходимости получите полную информацию по заказу: GET /v1/sberbusinesspay/orders/{externalId} — для сверки, отображения деталей продавцу и закрытия сделки на платформе.

Результат: оплата поступила на счет продавца, платформа видит статус и может автоматически завершить сделку (снять бронь, открыть доступ, распределить средства).