Платежный модуль Stripe

Гибкая интеграция Stripe для вашего интернет-магазина

Платежный модуль Stripe — это готовое решение для приема оплат на сайте, работающем на 1С-Битрикс. Модуль подключается к актуальной версии Stripe API (2023-08-16) и позволяет начать принимать платежи от клиентов из любой точки мира. Вы получаете полный контроль над процессом: от выбора режима работы до кастомизации внешнего вида платежной формы.

Система поддерживает два режима: тестовый (demo mode) для проверки и отладки, и боевой (live mode) для реальных транзакций. Это значит, что вы можете безопасно настроить всё на «песочнице», а затем одним переключением запустить прием настоящих платежей без переустановки модуля.

Два шаблона оплаты и полная свобода кастомизации

Модуль поставляется с двумя готовыми шаблонами. Первый — CUSTOM: классическая форма, на которой клиент видит кнопки для оплаты картами (Debit Card, Credit Card), а также через SEPA, SOFORT и GIROPAY. Второй — REDIRECT: минималистичное решение, которое сразу перенаправляет покупателя на защищённую страницу Stripe, минуя отображение кнопок на вашем сайте.

Если стандартные варианты не подходят под дизайн вашего магазина, вы можете создать собственный шаблон. Для этого достаточно разместить файл в одной из двух директорий: /local/php_interface/sale_payment/stripe/templates/ или /bitrix/php_interface/sale_payment/stripe/templates/. Система сама найдёт ваш шаблон, а если имя совпадёт с встроенным — приоритет будет у вашего файла. После этого нужный вариант выбирается в настройках модуля.

Автоматическое подтверждение оплаты через вебхуки

Чтобы заказы получали статус оплаченных без участия администратора, в модуле реализована поддержка вебхуков. Вам нужно скопировать файл stripeWebhook.php из корня модуля в любую публичную директорию сайта. Затем в личном кабинете Stripe перейти в раздел Developers → Webhooks и добавить новый endpoint, указав путь к скопированному файлу.

После создания endpoint необходимо настроить события. В блоке «webhook details» нажмите «update details» и отметьте два события: charge.succeeded и checkout.session.completed. Затем в блоке «Signing secret» скопируйте secret key и вставьте его в поле «Webhook-токен» в настройках платёжной системы на вашем сайте. После этого тестовая оплата автоматически подтвердит заказ — всё работает без лишних телодвижений.

События для разработчиков: полный контроль над процессом

Модуль предоставляет четыре ключевых события, которые позволяют влиять на логику оплаты на любом этапе. Событие OnBeforeStripeCharge срабатывает сразу после создания клиента (customer) в Stripe. Вы можете изменить массив параметров, который передаётся в метод \Stripe\Charge::create, и дополнить его своими данными — например, добавить мета-информацию или применить скидку.

Событие OnBeforeUpdateOrder вызывается в момент, когда модуль получает статус оплаты и готовится обновить заказ в системе. Вы можете подкорректировать массив полей перед вызовом CSaleOrder::Update или выполнить дополнительную логику, используя объект платежа и ID заказа. А события OnBeforeSuccessOutput и OnBeforeErrorOutput дают возможность полностью переопределить сообщения, которые видит пользователь после оплаты — как успешные, так и ошибочные. Это удобно, если нужно вывести кастомную вёрстку или редирект на другую страницу.

Поддержка и обратная связь

Разработчик модуля оставил прямой контакт для связи. Если у вас возникнут нарекания, вопросы или предложения по улучшению — можно написать на почту техподдержки. Это значит, что модуль не заброшен, а его автор готов дорабатывать решение под реальные потребности пользователей. Вы получаете не просто «коробку», а инструмент, который может эволюционировать вместе с вашим бизнесом.