Интеграция эквайринга Сбербанка: способы и требования

Интеграция эквайринга Сбербанка доступна через REST API, готовые модули для CMS и прямое подключение кассового оборудования. Выбор способа зависит от типа бизнеса: интернет-магазин, офлайн-точка или мобильное приложение. Перед подключением нужно заключить договор эквайринга с банком — без него доступ к тестовой среде и продуктовым ключам не предоставляется.

Что такое интеграция эквайринга и зачем она нужна

Эквайринг сам по себе — это приём платежей по картам. Интеграция — это технический этап, который связывает платёжный шлюз банка с вашей системой: сайтом, кассой, мобильным приложением или учётной программой.

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

Способы интеграции интернет-эквайринга

REST API

Это основной способ для разработчиков. Сбербанк предоставляет API платёжного шлюза, через который можно:

• регистрировать заказы и получать ссылку на оплату,
• проверять статус транзакции,
• выполнять частичный или полный возврат,
• управлять привязанными картами (для рекуррентных платежей).

Взаимодействие происходит по протоколу HTTPS. Запросы и ответы передаются в формате JSON или form-encoded, в зависимости от метода. Аутентификация — по логину и паролю, которые выдаются при подключении.

Ссылка эквайринга Сбербанка в тестовой среде и продуктовой среде отличается. Тестовый шлюз позволяет проверить сценарии оплаты без реальных транзакций. Продуктовый URL активируется после проверки интеграции банком.

Важно: номер ссылки в параметрах заказа — это уникальный идентификатор, который банк возвращает при регистрации заказа. Сохраняйте его на своей стороне: он понадобится для проверки статуса и возвратов.

Готовые модули для CMS и платформ

Для популярных платформ доступны готовые модули. Они избавляют от необходимости писать код с нуля.

Модуль эквайринга Сбербанка для CMS обычно требует ввести логин, пароль и выбрать режим работы (тест или продуктив). Остальная логика — регистрация заказа, получение ссылки, обработка колбэка — уже реализована внутри.

Перед установкой проверяйте совместимость версий модуля с вашей версией CMS и актуальность документации — некоторые сторонние модули могут быть не обновлены под текущий протокол шлюза.

Виджет оплаты

Для сайтов без собственной разработки доступен JavaScript-виджет. Он встраивается в страницу и открывает форму ввода карточных данных без перехода на сторонний сайт. Технически это тот же API, но логика регистрации заказа и отображения формы вынесена в готовый компонент.

Мобильный SDK

Для iOS и Android приложений Сбербанк предоставляет SDK. Он реализует платёжную форму внутри приложения и взаимодействует с API шлюза. Это позволяет не открывать браузер и сохранить пользователя внутри вашего интерфейса.

Протокол эквайринга Сбербанка: ключевые элементы

Протокол эквайринга описывает, как именно происходит обмен данными между вашей системой и шлюзом.

Базовый сценарий выглядит так:

1. Ваша система регистрирует заказ — отправляет сумму, валюту, идентификатор, URL возврата.
2. Шлюз возвращает идентификатор заказа на стороне банка и URL для оплаты.
3. Покупатель переходит по ссылке и вводит данные карты.
4. Банк обрабатывает транзакцию и уведомляет вашу систему через колбэк (returnUrl / failUrl).
5. Ваша система проверяет статус заказа через отдельный запрос к API.

Этот цикл важно реализовывать именно с финальной проверкой статуса — колбэк может не дойти при сетевых сбоях. Не считайте оплату подтверждённой только по редиректу.

Дополнительно протокол поддерживает двухстадийную оплату: сначала холдирование средств, затем списание. Это удобно для бронирований и заказов с отложенным исполнением.

Интеграция с кассовым оборудованием

Для офлайн-торговли и соблюдения 54-ФЗ эквайринг нужно совместить с онлайн-кассой. Здесь варианты зависят от оборудования:

• Смарт-терминал (например, EVOTOR или PAX) — касса и терминал в одном устройстве, интеграция минимальна.
• Отдельный POS-терминал + касса — требуется настройка протокола обмена между терминалом и кассовым ПО. Обычно это либо стандарт OPOS/JavaPOS, либо проприетарный интерфейс производителя.
• Встроенный эквайринг в кассовом ПО — некоторые системы (например, 1С:Розница, МойСклад) поддерживают работу с терминалами Сбербанка напрямую через своё API.

Конкретный порядок подключения терминала к кассе лучше уточнять у технической поддержки банка или поставщика кассового ПО — схемы разнятся в зависимости от оборудования.

Интеграция с учётными системами

Для автоматической сверки и проводок данные о транзакциях можно передавать в бухгалтерские и ERP-системы.

В 1С интеграция чаще всего строится через:

• загрузку выписок в формате банковского обмена (1С-совместимый формат),
• подключение через API с настройкой обработки на стороне 1С,
• готовые конфигурации от партнёров Сбербанка.

Для других систем — SAP, Битрикс24, amoCRM, МойСклад — уточняйте наличие коннекторов у разработчика или в партнёрской сети банка.

Требования к подключению

Чтобы начать техническую интеграцию, нужно выполнить несколько условий.

Со стороны бизнеса:

• Зарегистрированное ИП или юрлицо.
• Расчётный счёт (необязательно в Сбербанке, но счёт в другом банке нужно подтвердить).
• Подписанный договор эквайринга.
• Для интернет-эквайринга — работающий сайт с описанием товаров или услуг, политикой конфиденциальности и контактами.

Со стороны техники:

• Поддержка HTTPS на сайте (SSL-сертификат обязателен).
• Возможность обрабатывать HTTP-запросы от шлюза (колбэки).
• Логика проверки статуса заказа на вашей стороне.

После подключения к тестовой среде рекомендуется проверить все сценарии: успешную оплату, отказ, возврат и двухстадийную операцию — до перехода в продуктив.

Тестирование интеграции

Тестовая среда Сбербанка позволяет имитировать платежи без реального списания. Для тестирования банк предоставляет тестовые карточные данные — номера, CVV и сроки действия, которые активируют нужные сценарии.

Что проверить перед запуском:

1. Регистрация заказа — корректность передаваемых параметров.
2. Переход по ссылке оплаты — отображение формы.
3. Успешная оплата — статус обновляется в вашей системе.
4. Неуспешная оплата — заказ не переходит в статус оплаченного.
5. Возврат — сумма возвращается, статус меняется.
6. Колбэк — ваш сервер корректно принимает уведомления.

После тестирования нужно уведомить банк о готовности — переход в продуктив производится после проверки со стороны платёжного шлюза.

Частые вопросы