Интеграция 1С-Битрикс с CloudPayments: виджет, подписки, фискализация

Интеграция 1С-Битрикс с платёжной системой CloudPayments

Владельцы интернет-магазинов на 1С-Битрикс часто сталкиваются с падением конверсии при оплате: редирект на страницу банка отпугивает до 20% покупателей. CloudPayments решает эту проблему через Checkout Widget — данные карты вводятся прямо на сайте, конверсия растёт на 15–25%. Мы выполняем интеграцию с CloudPayments под ключ: виджет без редиректа, рекуррентные платежи, фискализация по 54-ФЗ. По нашим данным, стоимость интеграции обычно составляет от 30 000 до 70 000 руб в зависимости от объёма работ.

Как CloudPayments повышает конверсию в Битрикс?

CloudPayments предлагает две схемы оплаты. Checkout Widget — JS-виджет, форма открывается в popup или inline. Данные карты уходят напрямую в шлюз (PCI DSS), на ваш сервер — только токен транзакции. Это безопасно и не требует сертификации. API без редиректа требует, чтобы магазин собирал данные карты самостоятельно и передавал через REST — такой подход почти не используется из-за необходимости PCI DSS.

Типичная конверсия с редиректом — 2–3%, с виджетом — 4–6%. Разница особенно заметна на мобильных устройствах. CloudPayments даёт конверсию в 2 раза выше, чем при использовании редиректа. Виджет настраивается за 2–3 дня, включая серверные колбэки. Для сравнения: интеграция с Сбербанком через API занимает 5–7 дней, конверсия ниже.

Почему CloudPayments выгоднее альтернатив?

CloudPayments даёт готовую фискализацию — не нужно писать свой модуль для ОФД. Это экономит до 40% времени на разработку.

Как настроить виджет CloudPayments в Битрикс: пошаговая инструкция

1. Получите публичный и секретный ключи в личном кабинете CloudPayments.
2. В шаблоне оформления заказа (компонент bitrix:sale.order.checkout) добавьте ссылку на скрипт виджета:

<script src="https://widget.cloudpayments.ru/bundles/cloudpayments.js"></script>

3. Инициализируйте виджет с параметрами заказа (сумма, описание, invoiceId).
4. Обработайте колбэки onSuccess и onFail — в onSuccess отправьте запрос на сервер для подтверждения оплаты.
5. Настройте серверный обработчик check и pay с проверкой HMAC-подписи.
6. Протестируйте сценарии: успешный платёж, отмена, ошибка.

Подключение виджета

На странице оформления заказа в Битрикс (компонент bitrix:sale.order.checkout) добавляем скрипт и инициализируем виджет:

<script src="https://widget.cloudpayments.ru/bundles/cloudpayments.js"></script>

<script>
var widget = new cp.CloudPayments({language: 'ru-RU'});
widget.pay('auth',  // 'auth' — двухстадийная, 'charge' — одностадийная
    {
        publicId: 'pk_XXXXX',
        description: 'Оплата заказа #<?= $orderId ?>',
        amount: <?= $amount ?>,
        currency: 'RUB',
        invoiceId: '<?= $orderId ?>',
        accountId: '<?= $userId ?>',
        skin: 'mini',
        data: {
            orderId: '<?= $orderId ?>',
            csrfToken: '<?= bitrix_sessid() ?>',
        }
    },
    {
        onSuccess: function(options) {
            // Платёж прошёл — уведомить сервер
            fetch('/bitrix/tools/sale_ps_result.php', {
                method: 'POST',
                body: JSON.stringify({ orderId: options.invoiceId }),
            });
        },
        onFail: function(reason, options) {
            console.error('Payment failed:', reason);
        }
    }
);
</script>

В Битрикс виджет подключается в шаблоне компонента или в result_modifier.php. Мы передаём invoiceId — номер заказа, по которому потом подтверждаем оплату.

Серверная обработка: check и pay уведомления

CloudPayments отправляет два POST-запроса на ваш эндпоинт: Check — перед списанием, магазин должен ответить {"code":0}, если заказ существует; Pay — после успешного списания, подтверждение оплаты.

Обработчик (local/payment/cloudpayments/callback.php):

$data = json_decode(file_get_contents('php://input'), true);

// Проверка HMAC подписи
$hmac = base64_encode(hash_hmac('sha256', file_get_contents('php://input'), $apiSecret, true));
if ($hmac !== $_SERVER['HTTP_CONTENT_HMAC']) {
    http_response_code(403);
    exit;
}

$invoiceId = $data['InvoiceId'];  // наш orderId
$status    = $data['Status'];     // 'Completed', 'Cancelled' и т.д.

if ($status === 'Completed') {
    // Найти платёж по orderId, подтвердить
    $order = \Bitrix\Sale\Order::loadByAccountNumber($invoiceId);
    $paymentCollection = $order->getPaymentCollection();
    foreach ($paymentCollection as $payment) {
        if ($payment->getPaySystem()->getField('CODE') === 'cloudpayments') {
            $payment->setPaid('Y');
        }
    }
    $order->save();
}

header('Content-Type: application/json');
echo json_encode(['code' => 0]);

Проверка подписи обязательна. CloudPayments передаёт HMAC SHA-256 в заголовке Content-HMAC. Без проверки злоумышленник может подтвердить оплату фальшивым POST. Подробнее: Wikipedia: HMAC.

Рекуррентные платежи

CloudPayments поддерживает подписки: при первом платеже создаётся токен карты (Token), последующие списания делаются без участия покупателя:

// Первый платёж с сохранением токена — через виджет с параметром createReceipt
// Последующие платежи через API
$response = $this->apiRequest('payments/tokens/charge', [
    'Amount'      => 999,
    'Currency'    => 'RUB',
    'InvoiceId'   => $subscriptionId,
    'AccountId'   => $userId,
    'Token'       => $savedToken,
    'Description' => 'Подписка за февраль',
]);

Токен хранится в базе (например, в HL-блоке), привязанный к пользователю Битрикс. Комиссия за рекуррентные платежи такая же, как за обычные.

Что нужно для фискализации?

CloudPayments интегрируется с онлайн-кассами через параметр cloudPayments.CustomerReceipt в запросе виджета. Передаёте массив позиций заказа, ставку НДС, систему налогообложения. CloudPayments сам формирует чек через подключённую кассу и отправляет его покупателю на email или SMS.

Пример передачи данных в виджет:

var receipt = {
    Items: [
        {
            label: 'Товар 1',
            price: 500.00,
            quantity: 1,
            amount: 500.00,
            vat: 20,
        }
    ],
    taxationSystem: 0, // ОСН
    email: '[email protected]',
    phone: '+71234567890',
};
widget.pay('charge', { ..., cloudPayments: { customerReceipt: receipt } });

Что входит в работу

При заказе интеграции вы получаете:

• Настройка виджета на странице оформления заказа.
• Обработчик уведомлений check/pay с проверкой подписи.
• Интеграция рекуррентных платежей (опционально).
• Фискализация с передачей чеков (опционально).
• Тестирование всех сценариев: успех, отмена, ошибка.
• Документация по интеграции и доступы (логи, админка).
• Консультации по настройке онлайн-кассы в CloudPayments.

Сроки разработки

Наш опыт: более 5 лет работы с Битрикс и платёжными системами, 50+ успешных интеграций. Получите консультацию по настройке CloudPayments. Свяжитесь с нами — мы рассчитаем точные сроки за 1 день. Для точного расчёта обратитесь к нашим инженерам.

Как избежать типичных ошибок при подключении платёжных систем на 1С-Битрикс

Самая частая ошибка при интеграции — забыть про callback. Покупатель оплатил заказ, деньги списались, а статус в b_sale_order не обновился: менеджер видит «Ожидание оплаты» и начинает звонить клиенту. Причина — неправильный URL в настройках шлюза или обработчик, падающий с 500 при нестандартной структуре ответа. Мы предлагаем услуги по подключению платёжных систем на 1С-Битрикс с полным тестированием всех сценариев: успешная оплата, отказ, таймаут, частичный возврат, повторный callback.

Почему callback-уведомления критичны?

Каждый платёжный шлюз присылает уведомление на ваш сервер. Если обработчик не гарантирует идемпотентность — двойной вызов приведёт к двойному списанию. Мы всегда реализуем проверку по ID уведомления (external_id) и блокировку повторной обработки в \Bitrix\Sale\Order. Также критично настроить URL callback в личном кабинете агрегатора — /bitrix/tools/sale_ps_result.php для штатного модуля. Если используете кастомный обработчик, проверяем, что он отдаёт HTTP 200 даже при ошибке параметров (шлюз не должен повторять запрос бесконечно).

use Bitrix\Sale\Order;
use Bitrix\Main\Application;

// Получаем данные уведомления
$data = Application::getInstance()->getContext()->getRequest()->toArray();
// Проверяем подпись (зависит от агрегатора)
if (!checkSignature($data, 'SECRET_KEY')) {
    die('FAIL');
}
// Ищем заказ по внешнему ID
$order = Order::loadByExternalId((int)$data['order_number']);
if ($order && $order->isPaid() === false) {
    $order->setField('PAYED', 'Y');
    $order->save();
}
echo 'OK';

Как выбрать платёжный агрегатор для 1С-Битрикс?

Выбор агрегатора зависит от географии покупателей, среднего чека и потребности в рассрочке. Для России базовый набор — ЮKassa (все основные методы, фискализация из коробки) и CloudPayments (виджет на странице без редиректа, Apple Pay). Если работаете с крупными корпоративными клиентами — добавьте Сбербанк (SberPay, СБП). Для международных продаж — Stripe или PayPal. Мы часто используем двухуровневую схему: основной агрегатор + резервный (автопереключение при падении).

Какие платёжные агрегаторы и способы оплаты мы используем

ЮKassa

Один договор — все основные способы: карты Visa/MasterCard/МИР, ЮMoney, SberPay, интернет-банки, рассрочка. Фискализация по 54-ФЗ из коробки (через модуль sale). Штатный обработчик /bitrix/modules/sale/handlers/paysystem/yandexpay/ покрывает базовые сценарии. Для холдирования (двухстадийная оплата), подписок или сплит-платежей — кастомная интеграция через YooKassa API v3. Callback настраиваем на /bitrix/tools/sale_ps_result.php, парсим notification и обновляем \Bitrix\Sale\Order через setField('PAYED', 'Y').

CloudPayments

Заточен на конверсию: виджет оплаты прямо на странице чекаута, без редиректа на внешний домен. Покупатель не уходит с сайта — процент отказов на этапе оплаты падает. Поддерживает рекуррентные платежи (токенизация карты через cryptogram), Apple Pay и Google Pay. 3D Secure с интеллектуальной маршрутизацией — запрашивается только при высоком риске фрода. Интеграция с Битрикс — через REST API CloudPayments и кастомный обработчик в модуле sale.

Тинькофф Оплата

API-интеграция через TinkoffPaymentAPI (готовый модуль или ручная реализация). QR-код для оплаты через приложение, рассрочка «Тинькофф Кредит» — критично для дорогих товаров. Частичные возвраты через метод Cancel — без звонков в банк, всё из админки Битрикс.

Сбербанк (SberPay и СБП)

SberPay — оплата по push-уведомлению или QR, СБП — комиссия 0.4–0.7% против 1.5–2.5% по картам. На объёме это ощутимая экономия. Холдирование через API registerPreAuth / deposit. Учитываем, что для SberPay требуется подписание отдельного договора с банком.

Apple Pay и Google Pay

Оплата в два касания, без ввода данных карты. Подключаются через агрегатор (ЮKassa, CloudPayments, Тинькофф). Важные нюансы:

• Apple Pay требует верификации домена: файл apple-developer-merchantid-domain-association в /.well-known/. Без него кнопка не появится.
• Размещение кнопок строго по гайдлайнам Apple и Google — иначе отказ в ревью.
• Фоллбэк на стандартную форму оплаты, если устройство не поддерживает бесконтактную оплату.

Рассрочка, BNPL и работа с 54-ФЗ

Если средний чек от 30 000 ₽ и конверсия проседает — рассрочка снимает ценовой барьер. Мы подключаем:

• Тинькофф Рассрочка (3–24 месяца)
• Покупай со Сбером
• Мокка / Долями — BNPL: 4 платежа, 0% для покупателя

Интеграция: виджет с расчётом ежемесячного платежа на карточке товара («от 2 500 ₽/мес»), передача данных заказа в банк через API, обработка статусов (одобрение, отказ, ожидание документов) в обработчиках OnSaleStatusOrder.

Фискализация по 54-ФЗ — обязательное требование. Штраф за отсутствие чека — до 100% от суммы расчёта. В соответствии с Федеральным законом № 54-ФЗ кассовый чек должен быть отправлен покупателю в электронной форме. Подключаем АТОЛ Онлайн, Orange Data, Модуль.Касса, Эвотор, Штрих-М. Настройка в Битрикс — раздел «Кассы» в модуле sale:

• Ставка НДС, предмет и способ расчёта — ошибка в любом поле может привести к штрафу при проверке.
• Чеки при предоплате и частичной оплате (два чека: при оплате и при отгрузке).
• Чеки возврата при отмене через \Bitrix\Sale\Cashbox\Cashbox::addChecks().
• Мониторинг: если чек не ушёл — алерт менеджеру.

При торговле обувью, одеждой, парфюмерией обязательна передача кодов маркировки в чеке. Интеграция с «Честный ЗНАК», сканирование DataMatrix при сборке заказа, автоматический вывод из оборота при продаже через \Bitrix\Catalog\Product\Marking.

Сопровождение платежей: возвраты, мультивалюта, безопасность

Возвраты

Полный и частичный возврат без звонков в банк — через API агрегатора (refund / cancel). Чек возврата формируется автоматически, обновляется статус заказа, пересчитывается сумма, уведомляется покупатель. Сроки: электронные кошельки и СБП — 1–3 дня, банковская карта — до 30 рабочих дней (зависит от банка-эмитента).

Мультивалюта

Типы цен в b_catalog_price для каждой валюты, курсы через API ЦБ (\Bitrix\Currency\CurrencyManager::updateCBRFRates()) или ручной ввод. Конвертация на уровне каталога — покупатель видит цены в своей валюте. Для приёма долларов/евро подключаем Stripe, PayPal. Учитываем комиссии за конвертацию при расчёте маржинальности.

Безопасность

Данные карт обрабатываются на стороне сертифицированного шлюза (PCI DSS) — номер карты никогда не проходит через ваш сервер. Антифрод на уровне агрегатора. Логирование всех событий в b_sale_order_change для аудита. Мониторинг аномалий: скачок транзакций, нетипичная география — алерт.

Как мы работаем и ориентировочные сроки

1. Анализ — какие способы оплаты нужны, рынки, объём транзакций, текущий агрегатор.
2. Подбор решений — иногда два агрегатора лучше одного: ЮKassa как основной, CloudPayments как резерв — при падении одного трафик уходит на второй.
3. Интеграция — тестируем каждый сценарий: успешная оплата, отказ 3DS, таймаут шлюза, двойной callback, частичный возврат.
4. Фискализация — онлайн-касса, проверка корректности чеков на тестовых заказах.
5. Мониторинг — алерты при сбоях шлюза, дашборд конверсии на этапе оплаты.

Что входит в работу

• Полная настройка выбранных платёжных систем в 1С-Битрикс: модули, обработчики, callback, тестирование.
• Документация по интеграции (схема работы шлюзов, описание обработчиков, логи).
• Обучение вашего менеджера работе с платёжными модулями и возвратами.
• Техническая поддержка на этапе запуска и первые 2 недели эксплуатации.
• Мониторинг — настраиваем алерты на ошибки и падение конверсии.

Все работы выполняются сертифицированными разработчиками 1С-Битрикс. Гарантируем работоспособность каждого сценария. Для быстрой оценки вашего проекта получите консультацию — просто оставьте заявку на сайте. Закажите интеграцию платёжных систем под ключ с фискализацией и защитой данных. Свяжитесь с нами, чтобы подобрать оптимальное решение для вашего бизнеса — мы поможем с выбором агрегатора и реализуем полный цикл интеграции.