CloudPayments
Войти

Интеграция и API: интернет‑эквайринг, драйверы, модули

Получить CloudPayments бесплатно

Интеграция и API: интернет‑эквайринг, драйверы, модули

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

Эквайринг‑интеграция — это подключение сайта, приложения или кассовой системы к услугам интернет‑эквайринга для приема онлайн‑платежей банковскими картами, по QR‑коду СБП и другими способами. Правильная интеграция определяет конверсию, скорость оплаты, наличие возвратов, безопасность и соответствие требованиям 54‑ФЗ.

Если вы впервые изучаете тему, начните с основ: что такое эквайринг и какие у него виды — см. материалы:

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

Способы интеграции: API, модули, драйверы

Ниже — обзор основных способов подключить интернет‑эквайринг для сайта (API, модули, драйверы, коннекторы). Выбирайте путь с учетом ваших сроков, компетенций и нужных функций.

Получить CloudPayments бесплатно
Способ Где уместен Плюсы Минусы
Прямой API эквайринга (REST/JSON) Свой сайт/приложение, сложные сценарии Полный контроль UX, гибкая логика, вебхуки, кастомные статусы Нужны разработчики, тестирование, поддержка
Модуль эквайринга (CMS/CRM) Bitrix, WooCommerce, OpenCart и др. Быстрый старт, типовые настройки, оплата «из коробки» Ограниченная кастомизация, зависит от версии CMS
SDK/виджеты провайдера Web/iOS/Android Быстрый UI‑старт, поддержка 3‑DS 2, токены Меньше контроля над фронтендом
Драйвер эквайринга для касс/терминалов ОФД/кассы, смарт‑терминалы, офлайн+онлайн Интеграция с фискальными чеками, единый поток Сложнее внедрение, привязка к железу
No‑code/коннекторы (например, SBiS, Vendista) Маркетплейсы, SaaS‑витрины Минимум кода, быстрая регистрация эквайринга Ограничения по кастомизации, зависимость от платформы

Примечания:

  • Драйвер эквайринга применяют, если оплата связана с кассой и печатью чеков, в т.ч. для смарт‑терминалов — см. обзор смарт‑терминалов Эвотор, PAX, MSPOS, AQSI.
  • Для сценариев «эквайринг интернет‑онлайн» в интернет‑магазине старт обычно проще через модуль, затем — миграция на API при росте требований.

Архитектура и поток платежей

Классическая схема интернет‑эквайринга:

![Схема потока платежа: клиент — сайт — платежный шлюз — банк — 3‑DS — вебхук — мерчант]

Этапы:

  1. Инициация платежа (create payment) на стороне мерчанта через API эквайринга.
  2. Перенаправление/виджет для ввода карты, 3‑DS 2.x аутентификация.
  3. Авторизация и списание (authorize/capture) — сразу или двухстадийно (холд).
  4. Уведомление по вебхуку о финальном статусе.
  5. Отражение статуса в системе, формирование фискального чека (54‑ФЗ).

Полезные материалы:

Безопасность, 54-ФЗ и PCI DSS

Прием карт — зона повышенных требований:

  • PCI DSS: если вы не храните/не обрабатываете карточные данные на своем сервере (используете хостед‑форму/виджет), достаточно SAQ A; при прямой обработке — расширенные требования.
  • 3‑DS 2.2: снижает риск мошенничества и чарджбеков, повышает конверсию за счет фрикционных сценариев.
  • Подпись запросов: HMAC‑SHA256, OAuth2, mTLS — зависят от провайдера.
  • 54‑ФЗ: при оплате обязателен фискальный чек. Интеграция «эквайринг — онлайн‑касса — банк» выстраивается через кассовый сервер/ОФД или готовые драйверы. Подробнее — Чеки и онлайн‑касса.
  • Для QR СБП — динамический QR (C2B), подтверждение по пушу в мобильном банке, нет комиссий для плательщика. См. QR‑СБП эквайринг.

Пошаговый план подключения

  1. Регистрация эквайринга у банка/провайдера и заключение договора — см. Договор эквайринга и Подключение/отключение.
  2. Доступ в личный кабинет интернет‑эквайринга: получение API‑ключей, секретов, тестового «sandbox».
  3. Настройка методов оплаты (карты, SBP, Apple/Google Pay), валюты (RUB/643), режим авторизация/списание.
  4. Конфигурация вебхуков: URL, подпись, retry‑механика, idempotency.
  5. Интеграция кассы по 54‑ФЗ: «эквайринг онлайн‑касса банк» и формирование чека. Подробнее — Чеки и онлайн‑касса.
  6. Тест‑кейсами покрыть сценарии успеха, отмены, возвратов, фрод‑фильтров.
  7. Переключение на прод, мониторинг, регламенты инцидентов — см. Поддержка эквайринга.

Примеры API-запросов и вебхуков

Ниже — типовой пример создания платежа у многих провайдеров (синтаксис схематичный):

POST /api/payments
Headers:
  Authorization: Bearer <api_key>
  Idempotency-Key: <uuid>
Body (JSON):
{
  "amount": {"value": "1500.00", "currency": "RUB"},
  "capture": true,
  "confirmation": {"type": "redirect", "return_url": "https://example.ru/return"},
  "description": "Order #12345",
  "metadata": {"order_id": 12345}
}

Типовой вебхук об успешной оплате:

POST /webhooks/payments
Body (JSON):
{
  "event": "payment.succeeded",
  "object": {
    "id": "pay_abc123",
    "status": "succeeded",
    "amount": {"value": "1500.00", "currency": "RUB"},
    "metadata": {"order_id": 12345}
  },
  "signature": "<hmac>"
}

Важно: валидируйте подпись, обрабатывайте повторы (retry), используйте idempotency для безопасного повторного выполнения запросов.

Модули для CMS/CRM и интеграция с 1С

  • CMS‑модули (модуль эквайринга): 1C‑Bitrix, WooCommerce, OpenCart, CS‑Cart. Позволяют быстро включить «интернет эквайринг интернет‑платежей» и работать без глубокого кода.
  • SBiS эквайринг и Вендиста эквайринг: примеры no‑code/low‑code‑платформ, где платежи подключаются через готовые коннекторы.
  • 1С: популярные сценарии — автоматизация оплат, сверки и возвратов. Смотрите наши практические руководства:

Если вы используете кассовые драйверы/смарт‑терминалы, обратите внимание на связку с эквайрингом, чтобы чеки формировались корректно и вовремя — см. POS‑терминалы и кассы.

Банки и провайдеры: где искать API и личный кабинет

Большинство банков и платёжных провайдеров предоставляют API, SDK и личный кабинет интернет‑эквайринга с отчетами, реестрами, управлением ключами и webhook‑логами. Для ориентира по рынку и тарифам:

Подбор по сегменту:

Продвинутые сценарии: холд, подписки, SBP, Pay‑by‑Link

  • Двухстадийная оплата (authorize/capture): холд средств при бронированиях и услугах с переменной ценой.
  • Подписки/регулярные списания: tokenization, off‑session списания по согласию клиента.
  • SBP‑оплата: динамический QR, deeplink в мобильный банк, быстрые зачисления. См. QR‑СБП эквайринг.
  • Pay‑by‑Link: счет/ссылка на оплату, удобна для инвойсинга и оплаты услуг без корзины.
  • Частичные возвраты, отмены, чарджбеки — регламенты и сроки см. Оперативные вопросы и возвраты.

Надежность, производительность, мониторинг

Рекомендации по SLA и стабильности:

  • Используйте idempotency keys для всех критичных операций.
  • Таймауты и экспоненциальный retry на уровне клиента.
  • Фиксация статуса по вебхуку, а не только по синхронному ответу.
  • Логи запросов/ответов с маскированием персональных данных.
  • Метрики (RTT, error rate, conversion) и алерты.
  • Fallback‑методы оплаты: SBP, Pay‑by‑Link при отказе ввода карты.

Частые ошибки и чек-лист запуска

Проблема Причина Как исправить
Оплата прошла, но заказ «висит» Вебхук не доставлен/не подтвержден Разрешите вход из IP провайдера, реализуйте повторную доставку, подтверждение 200 OK
Дубли платежей Отсутствует idempotency Добавьте Idempotency‑Key на create/capture
Чек не пробит Нет связки с кассой/ошибка ФФД Настройте интеграцию кассы, проверьте ФФД 1.2 и предмет расчета
Низкая конверсия 3‑DS Жесткие фрод‑настройки Проверьте 3‑DS 2, корректность данных клиента, просите минимум полей
«Валюта не поддерживается» Неверный код Используйте RUB/643 для РФ

Чек‑лист перед продом:

  • Пройдены кейсы успех/отмена/возврат/фрод‑отклонение.
  • Вебхуки подписаны, ретраи обрабатываются.
  • Касса печатает чек в нужный момент (оплата/возврат).
  • Логи и мониторинг включены, оповещения настроены.
  • Документация и регламенты эскалации для команды — см. Поддержка эквайринга и FAQ.

Тарифы, комиссии и выбор провайдера

На итоговую стоимость влияют тарифы на эквайринг, оборот, доля фрода, MCC‑категория, способ оплаты (карта/SBP), схема выплат и реестры. Для сравнения условий смотрите:

При выборе учитывайте функциональность API эквайринга, SLA, наличие личного кабинета, скорость поддержки и готовые модули. Если важна простая «регистрация эквайринга» и быстрый старт — выбирайте провайдера с широким набором модулей и понятным кабинетом.

Итоги и следующий шаг

Грамотная эквайринг‑интеграция — это баланс между скоростью запуска (модуль/виджет) и гибкостью (прямой API, драйвер эквайринга для касс). Определите сценарии оплат, требования к UX и 54‑ФЗ, затем выбирайте провайдера и метод подключения.

Готовы перейти к практике? Посмотрите интернет‑эквайринг для сайта, сравните банки и тарифы, изучите договор и подключение и настройте рабочий процесс чеков по 54‑ФЗ. Нужна помощь с выбором/интеграцией — обращайтесь в поддержку.

Получить CloudPayments бесплатно