Интеграции и API: подключение интернет‑эквайринга к сайту и приложению

Table of contents

• Варианты интеграции
• Быстрый старт: от заявки до первого платежа
• API интернет‑эквайринга Сбер: ключевые методы
• Webhook уведомления платежей
• Плагины CMS: Битрикс, WooCommerce и другие
• SDK оплаты Сбер для iOS/Android
• Безопасность, 3‑D Secure и 54‑ФЗ
• Тестирование и мониторинг
• Частые сценарии: возвраты, рекуррентные, СБП
• Тарифы, сроки и поддержка
• Итоги

Варианты интеграции

Интеграция эквайринга возможна несколькими способами — от «из коробки» модулей CMS до гибкой работы через API. Выберите подход в зависимости от стека, сроков и требуемого контроля над пользовательским опытом.

![payment-flow-diagram]

Три уровня подключения:

• Плагины CMS — быстрый запуск без программирования. Подходят интернет‑магазинам на популярных движках.
• SDK/виджет — natively-дружелюбные сценарии в мобильных приложениях и на веб‑странице, без хранения карточных данных на вашем сервере.
• Прямое API интернет‑эквайринга Сбер — максимальная гибкость, собственная платежная логика, расширенная аналитика.

Сравнение способов (кратко):

Способ	Когда выбирать	Скорость запуска	Трудозатраты	Контроль UX
Плагин CMS	Готовый интернет‑магазин	Быстро	Низкие	Средний
SDK/виджет	Приложения iOS/Android, современный веб	Средне	Средние	Высокий
Прямое API	Кастомные проекты, сложная логика	Дольше	Выше	Максимальный

О продуктах и каналах оплаты — в разделе Интернет‑эквайринг. Если нужны платежи в офлайне, рассмотрите также Торговый эквайринг или Мобильный эквайринг.

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

1. Заявка и договор

• Оставьте заявку на подключение в разделе Подключение. Ознакомьтесь с актуальными Тарифами.

1. Доступы и настройки

• Получите идентификатор магазина и секретные ключи для «боевого» и тестового окружений.
• Укажите адреса возврата (success/fail) и адрес для webhook уведомлений.

1. Выбор интеграции

• Плагин для вашей CMS, SDK оплаты или прямой API — ориентируйтесь на сроки и требования бизнеса.

1. Тестирование

• Прогоните базовые сценарии: успешная оплата, отказ, отмена, возврат. Проверьте формирование чека по 54‑ФЗ и зачисление в разделе Выплаты и зачисления.

1. Запуск

• Переведите ключи и URL на «прод», включите мониторинг и оповещения.

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

Если вам нужен полный контроль над платежным потоком, используйте API интернет‑эквайринга Сбер (поисковый запрос: «api интернет эквайринг сбер»). Типичный набор методов включает:

• Создание платежа (инициация транзакции и редирект/открытие хост‑формы).
• Подтверждение/завершение платежа (capture) — для двухстадийных сценариев.
• Отмена (cancel) — до списания средств.
• Получение статуса (get/payment) — для синхронизации вашего заказа с платежом.
• Создание/подтверждение возврата — если возвраты нужны на стороне API, см. раздел Возвраты и чарджбеки.

Пример тела запроса на создание платежа (схематично):

POST /payments
{
  "amount": 100000,                 // в минимальных единицах (копейки)
  "currency": "RUB",
  "orderId": "ORD-2025-0001",
  "description": "Оплата заказа",
  "returnUrl": "https://example.ru/pay/return",
  "callbackUrl": "https://example.ru/webhooks/sber",
  "receipt": {                      // для 54‑ФЗ
    "email": "buyer@example.ru",
    "items": [{"name": "Товар", "price": 100000, "qty": 1, "vat": "vat20"}]
  },
  "metadata": {"userId": "123"},
  "idempotencyKey": "a1b2c3-..."
}

Практики интеграции:

• Идемпотентность: передавайте уникальный idempotencyKey для повторных попыток без дублей.
• Подпись/проверка: используйте секрет/ключ для проверки подлинности ответов.
• 54‑ФЗ: формируйте состав чека корректно. Подробнее — в разделе Документы 54‑ФЗ.
• 3‑D Secure 2.0: поддерживайте редирект/флоу аутентификации для повышения одобряемости.

Webhook уведомления платежей

Webhook уведомления платежей позволяют вашему серверу получать события в реальном времени и не опрашивать API лишний раз. Базовые рекомендации:

• События: payment.pending, payment.succeeded, payment.failed, refund.succeeded, chargeback.opened и т.д.
• Подпись: валидируйте подпись/секрет вебхука, сверяйте хедеры и время отправки.
• Доступность: держите конечную точку доступной по HTTPS, с корректными кодами ответов 2xx.
• Повторы: обрабатывайте идемпотентно — одно и то же событие может прийти несколько раз.
• Логи и аудит: записывайте payload и результат обработки для расследований.

Подтягивайте финальный статус заказа из вебхука, а не из страницы «успех», чтобы избежать ложноположительных сценариев при разрыве сессии пользователя.

Плагины CMS: Битрикс, WooCommerce и другие

Для быстрого запуска доступны плагины CMS Сбербанк. Наиболее популярные сценарии:

• 1C‑Битрикс: «битрикс модуль оплаты сбербанк» — устанавливается через маркетплейс, настраиваются ключи/URL и статусы заказов.
• WordPress: «woocommerce sberbank» — модуль для WooCommerce; включите метод оплаты, укажите данные магазина и webhook.
• Другие CMS: OpenCart, CS‑Cart и др. — доступны официальные и партнерские плагины.

Шаги подключения плагина:

1. Установка расширения через магазин вашей CMS.
2. Ввод идентификатора магазина, публичного/секретного ключей.
3. Настройка URL возврата и вебхука, выбор статусов «Оплачено/Ошибка».
4. Тестовый платеж и проверка чеков по 54‑ФЗ.

Плагины — лучший путь «сегодня на сегодня». Если нужен особый UX, каскадные платежи, нестандартные корзины — переходите на SDK или API.

SDK оплаты Сбер для iOS/Android

SDK оплаты Сбер (sdk оплаты сбер) упрощает встраивание платежей в мобильные приложения и современный веб:

• Нативный UX: знакомые пользователю экраны, автозаполнение, сохраненные карты (токенизация).
• Безопасность: карточные данные не проходят через ваш сервер, упрощая соответствие PCI DSS.
• 3‑D Secure 2.0: обработка дополнительных шагов аутентификации встроена.
• Гибкость: темизация, локализация, расширенные методы оплаты (включая СБП при необходимости). См. также СБП‑эквайринг.

Схема внедрения:

• Подключите SDK, укажите ключи/merchant-данные.
• На бэкенде создавайте платеж и отдавайте токен/intent в приложение.
• Обрабатывайте коллбеки SDK и подтверждайте оплату на сервере.

Безопасность, 3‑D Secure и 54‑ФЗ

Платежи — зона повышенных требований к безопасности. Основное:

• PCI DSS: при использовании хост‑формы/SDK вы не храните PAN на своей стороне, снижая требования.
• 3‑D Secure 2.0: снижает риски мошенничества и повышает вероятность одобрения банком‑эмитентом.
• Защита API: шифрование TLS, контроль исходящих IP вебхуков, ограничение доступа по спискам, ротация ключей.
• Антифрод: анализ аномалий, лимиты на транзакции, проверка географии и устройств.
• 54‑ФЗ: корректно пробивайте чеки и отправляйте их покупателю. Детали и примеры — в разделе Документы 54‑ФЗ.

Подробнее о методах защиты — в разделе Безопасность.

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

Гладкий запуск невозможен без проработанных процедур QA и наблюдаемости:

• Песочница: используйте тестовые карты и сценарии (approve/decline/3DS) в sandbox‑среде.
• Идемпотентность: повторяйте запросы при сетевых сбоях, избегая дублей платежей.
• Логи: фиксируйте запрос/ответ API и payload вебхуков (с маскированием чувствительных данных).
• Мониторинг: настраивайте алерты по ошибкам, тайм‑аутам, конверсиям, проценту возвратов.
• Отчетность: сверьте суммы зачислений и комиссии в разделе Выплаты и зачисления.

FAQ по частым вопросам интеграции смотрите в разделе FAQ.

Частые сценарии: возвраты, рекуррентные, СБП

• Возвраты и чарджбеки: инициируйте полные/частичные возвраты через API или личный кабинет. Про цессионные сроки и споры — в разделе Возвраты и чарджбеки.
• Рекуррентные платежи: сохранение токена карты (card-on-file) для подписок и регулярных списаний — реализуется через API/SDK с привязкой плательщика.
• СБП: мгновенные переводы по QR/ссылке, низкая комиссия, высокий процент одобрений. Детали — в разделе СБП‑эквайринг.
• Омниканал: объединяйте онлайн‑и офлайн‑продажи (например, сайт + POS) — смотрите Торговый эквайринг и Терминалы.

Если вы работаете через корпоративный аккаунт, изучите возможности SberBusiness эквайринга и отраслевые кейсы в разделе Отраслевые решения.

Тарифы, сроки и поддержка

• Условия и стоимость: актуальные ставки и комиссии — в разделе Тарифы.
• Подключение: список документов и шаги онбординга — в разделе Подключение.
• Поддержка интеграции: технические вопросы можно адресовать через форму из раздела Контакты.

Совет: перед стартом закрепите SLA (время реакции на инциденты), режимы обслуживания и регламенты обновлений плагинов/SDK.

Итоги

API интернет‑эквайринга Сбер, плагины CMS и SDK оплаты Сбер покрывают все типовые сценарии онлайн‑продаж: от быстрого MVP до высоконагруженных площадок. Выберите удобный способ интеграции, включите webhook уведомления платежей, проверьте работу чеков по 54‑ФЗ и запуститесь с прозрачными тарифами.

Готовы подключиться? Оставьте заявку в разделе Подключение и получите первый платеж уже сегодня. Хотите сравнить условия — смотрите Тарифы, а по вопросам интеграции загляните в FAQ или напишите в Контакты.