Подключение CloudPayments

CloudPayments — это платёжный сервис с оплатой прямо на сайте через виджет, без редиректа на сторонний домен. В 1С-Битрикс он подключается отдельным модулем из Маркетплейса, а связка держится на двух ключах и корректно настроенных серверных уведомлениях. Разберём подключение по шагам и типовые грабли.

Что такое CloudPayments и чем он отличается

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

Ключевые особенности, которые влияют на настройку в Битрикс:

• Виджет вместо редиректа — оплата происходит в модальном окне, поэтому корректная работа зависит от JavaScript и HTTPS на витрине;
• Асинхронные уведомления — результат платежа магазин узнаёт не по возврату браузера, а по серверным callback-запросам от CloudPayments;
• Две схемы списания — одностадийная (сразу списание) и двухстадийная (холдирование средств и последующее подтверждение);
• Фискализация по 54-ФЗ — чеки пробиваются через встроенную онлайн-кассу CloudKassir или подключённую ККТ.

Что нужно подготовить до настройки

Перед тем как открывать админку Битрикс, соберите доступы и проверьте базовые требования — это экономит половину времени на отладке.

1. Зарегистрированный и подтверждённый личный кабинет CloudPayments (сайт прошёл модерацию, магазин активен).
2. Public ID — публичный идентификатор сайта (виден в разделе «Настройки»).
3. Пароль для API (API Secret) — секретный ключ, который используется для проверки подписи уведомлений. Его нельзя публиковать на витрине.
4. Действующий SSL-сертификат: без HTTPS виджет не запустится, а браузеры заблокируют смешанный контент.
5. Модуль интеграции. Стандартной поставки в ядре нет — ставится решение из Marketplace (раздел Настройки → Marketplace → Каталог решений).

Установка модуля и создание платёжной системы

Официальная интеграция ставится как модуль Маркетплейса. После установки в списке обработчиков появляется отдельный тип платёжной системы CloudPayments.

Порядок действий:

1. Установите модуль через Настройки → Marketplace, дождитесь завершения мастера и, если требуется, обновите структуру таблиц.
2. Перейдите в Магазин → Платёжные системы (или Sale → Настройки → Платёжные системы в старых редакциях) и нажмите «Добавить».
3. В поле «Обработчик» выберите CloudPayments.
4. Укажите название и сортировку — под этим именем способ оплаты увидит покупатель в оформлении заказа.

Если магазин многосайтовый или использует несколько типов плательщиков, платёжную систему нужно включить для нужных сайтов и привязать к соответствующим типам плательщиков, иначе она не появится на витрине.

Параметры обработчика: ключи и соответствие полей

В карточке платёжной системы заполняются настройки обработчика. Минимальный набор — это два ключа из личного кабинета и соответствие бизнес-полей заказу.

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

Настройка уведомлений (Check, Pay, Fail, Confirm)

Это самый важный и самый частый источник ошибок. Статус заказа в Битрикс меняется не в момент, когда покупатель нажал «Оплатить», а когда CloudPayments отправит серверное уведомление на ваш URL. Если URL не прописан или недоступен, деньги спишутся, но заказ останется неоплаченным.

В личном кабинете CloudPayments в разделе Настройки → Уведомления (API) укажите адреса обработчика вашего сайта для событий:

• Check — проверочное уведомление перед списанием: магазин подтверждает, что заказ существует и сумма верна;
• Pay — уведомление об успешной оплате: именно оно переводит заказ в статус «оплачен»;
• Fail — уведомление о неуспешной попытке;
• Confirm — подтверждение при двухстадийной схеме;
• Refund — возврат средств.

Точный URL обработчика даёт установленный модуль — сверьтесь с его документацией и подставьте свой домен по HTTPS. Метод уведомлений выбирайте согласованно с модулем (обычно POST), а проверку подписи по паролю для API оставьте включённой — это защищает от поддельных запросов.

Схема списания, тест и фискализация

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

Одностадийная схема — деньги списываются сразу после оплаты. Подходит для товаров в наличии. Двухстадийная — сначала холдирование (блокировка суммы), затем подтверждение (Confirm) при отгрузке или частичное подтверждение/отмена. Удобна, когда наличие товара подтверждается вручную.

Тестовый режим. Проверяйте платёж тестовыми картами из документации CloudPayments (успех, отказ, 3-D Secure). Убедитесь, что после оплаты заказ в Битрикс сам перешёл в «оплачен» по уведомлению Pay, а не был отмечен вручную.

Фискализация 54-ФЗ. Если вы работаете с физлицами, при оплате должен формироваться чек. CloudPayments умеет пробивать чеки через CloudKassir; для этого в объект оплаты передаётся состав корзины (позиции, цены, ставки НДС, признак предмета/способа расчёта). Проверьте, что модуль корректно собирает данные корзины из заказа Битрикс, иначе чек уйдёт без номенклатуры.

Итог

Подключение CloudPayments к 1С-Битрикс сводится к четырём вещам: установить модуль из Маркетплейса, создать платёжную систему с обработчиком CloudPayments, аккуратно ввести Public ID и пароль для API, а главное — правильно настроить серверные уведомления Check и Pay и проверить всё в тестовом режиме. Отдельно продумайте схему списания и фискализацию, чтобы чеки уходили с корректным составом корзины.

Если магазин уже в проде и рисковать платежами не хочется, мы в B2Bsite настраиваем эквайринг под ключ: подключаем модуль, отлаживаем уведомления и статусы заказов, связываем оплату с фискализацией и обменом с 1С. Поможем и с диагностикой, если платежи проходят, а заказы не закрываются.