Интеграция Stripe с 1С-Битрикс: настройка и реализация

Интеграция Stripe с интернет-магазином на Битрикс: от проектирования до деплоя

Покупатель добавил товары в корзину, ввёл данные карты — и страница зависла. Платёж не прошёл, заказ потерян, клиент ушёл к конкуренту. Такое случается, если интеграция платежного шлюза с Битрикс сделана на скорую руку: нет обработки вебхуков, нет проверки подписи, нет идемпотентности. Stripe как одна из самых надёжных платёжных систем требует аккуратной связки с CMS. У нас за плечами более 50 успешных проектов по интеграции Stripe с 1С-Битрикс — от стартапов до enterprise-магазинов с оборотами в сотни тысяч долларов. Каждая интеграция проходит нагрузочное тестирование и проверку на безопасность.

Stripe покрывает весь цикл: авторизация карты, захват средств, возвраты, подписки, 3D Secure. Работает с картами Visa, Mastercard, AmEx, Apple Pay, Google Pay и локальными методами (SEPA, iDEAL, Klarna). Stripe Checkout снимает с мерчанта ответственность за PCI DSS — все данные карт обрабатываются на стороне Stripe (Wikipedia: PCI DSS). Доступность методов зависит от страны мерчанта.

Выбор между Checkout и Elements

Для большинства магазинов на Битрикс мы рекомендуем Stripe Checkout. Этот подход проще реализации примерно в 3 раза — меньше кода, автоматическое обновление 3DS, и покупатель видит знакомый интерфейс Stripe. Если нужен полный контроль над дизайном формы оплаты, используйте Stripe Elements — он требует больше серверной логики, но даёт гибкость. Выбор зависит от требований к кастомизации и времени на разработку.

Как интегрировать Stripe в Битрикс за 5 шагов?

1. Проектирование — выбираем подход (Checkout или Elements), согласовываем схему возвратов и подписок.
2. Разработка обработчика — пишем класс-наследник \Bitrix\Sale\PaySystem\ServiceHandler, реализуем initiatePay(), processRequest(), refund().
3. Настройка вебхуков — регистрируем endpoint в Stripe Dashboard, подписываемся на события. Обязательно верифицируем подпись через Stripe-Signature.
4. Тестирование — используем тестовые ключи и карту 4242 4242 4242 4242. Проверяем успешные платежи, отказы, возвраты.
5. Деплой — меняем ключи на боевые, проводим нагрузочное тестирование. Сроки: Checkout — 3–4 дня, Elements — 5–7 дней.

Все тестовые транзакции не списывают реальные средства. Подробнее в документации Stripe.

Что входит в работу по интеграции Stripe

• Разработка обработчика платежной системы (класс-наследник \Bitrix\Sale\PaySystem\ServiceHandler).
• Настройка вебхуков и проверка идемпотентности.
• Реализация полных и частичных возвратов через \Stripe\Refund.
• Поддержка 3D Secure (Checkout включает автоматически).
• Подключение Apple Pay и Google Pay (верификация домена через файл .well-known/apple-developer-merchantid-domain-association).
• Тестирование на тестовых и боевых ключах.
• Передача полной документации и обучение сотрудников.
• Гарантия корректной обработки платежей — все интеграции проходят нагрузочное тестирование.

Создание Checkout Session

\Stripe\Stripe::setApiKey($secretKey);

$session = \Stripe\Checkout\Session::create([
    'payment_method_types' => ['card'],
    'line_items' => [[
        'price_data' => [
            'currency'     => 'eur',
            'unit_amount'  => $amountInCents,
            'product_data' => ['name' => 'Заказ №' . $orderId],
        ],
        'quantity' => 1,
    ]],
    'mode'        => 'payment',
    'success_url' => $successUrl . '?session_id={CHECKOUT_SESSION_ID}',
    'failure_url' => $cancelUrl,
    'metadata'    => ['bitrix_order_id' => $orderId],
]);

{CHECKOUT_SESSION_ID} — плейсхолдер Stripe, подставляет реальный ID. По нему в processRequest() сверяем принадлежность заказу.

Обработка вебхуков

Вебхуки важнее, чем success_url — покупатель может закрыть вкладку до редиректа. Stripe отправляет checkout.session.completed независимо от поведения браузера. Подробнее о вебхуках можно прочитать в Wikipedia.

Обязательные проверки:

1. Верификация подписи через заголовок Stripe-Signature — иначе любой может имитировать платёж.
2. Идемпотентность — перед сменой статуса заказа проверяем текущий статус в b_sale_order.
3. Ответ 200 OK в течение 3 секунд — иначе Stripe повторит доставку.

Подписываемся на события: checkout.session.completed, payment_intent.payment_failed, charge.refunded. Подробнее в документации Stripe.

$payload = @file_get_contents('php://input');
$sigHeader = $_SERVER['HTTP_STRIPE_SIGNATURE'];
$event = \Stripe\Webhook::constructEvent($payload, $sigHeader, $endpointSecret);

if ($event->type === 'checkout.session.completed') {
    $session = $event->data->object;
    $orderId = $session->metadata->bitrix_order_id;
    // Логика обновления статуса заказа
}

Возвраты и частичные возвраты

$refund = \Stripe\Refund::create([
    'payment_intent' => $paymentIntentId,
    'amount'         => $refundAmountInCents,
    'reason'         => 'requested_by_customer',
]);

Stripe допускает несколько частичных возвратов до полной суммы транзакции.

Сравнение Checkout и Elements

По нашим данным, Checkout экономит до 40% времени на разработку и тестирование. Если затрудняетесь с выбором, свяжитесь с нами — подберём оптимальный вариант под ваш бюджет и сроки.

Сроки

Настройки в административной панели Битрикс

Почему Stripe — оптимальное решение для Битрикс?

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