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

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

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

Table of contents

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

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

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

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

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

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

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

Примечания:

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

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

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

Этапы:

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

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

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

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

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

  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С

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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