Что умеет решение
Модуль обеспечивает интеграцию с платежной системой Stripe для приема оплат. Поддерживаемая версия API Stripe — 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 из корня модуля в доступную по URL папку. В личном кабинете Stripe перейдите в раздел Developers -> Webhooks, создайте новый endpoint и в настройках этого endpoint в блоке webhook details нажмите update details.
В открывшемся окне укажите поддержку событий charge.succeeded и checkout.session.completed, затем нажмите кнопку обновления конечной точки. В разделе «Signing secret» нажмите «click to reveal» и скопируйте секретный ключ. Перейдите в административную панель сайта, откройте настройки платежной системы Stripe и вставьте скопированный ключ в поле Webhook-токен. Выполните тестовую оплату.
Поддерживаемые события:
OnBeforeStripeCharge — срабатывает после создания клиента. Передаются параметры: &$arCreateFields (массив данных для \Stripe\Charge::create) и $customer (объект, созданный через \Stripe\Customer::create).
OnBeforeUpdateOrder — срабатывает после получения статуса оплаты. Передаются параметры: &$arFields (массив полей для CSaleOrder::Update), $charge (объект \Stripe\Charge::create) и $orderID (идентификатор заказа).
OnBeforeSuccessOutput — срабатывает перед выводом сообщения об успехе. Передаются параметры: &$output (строка или HTML-код результата), $arFields (массив полей заказа, аналогичный используемому в CSaleOrder::Update) и $orderID (идентификатор заказа).
OnBeforeErrorOutput — срабатывает перед выводом сообщения об ошибке. Передаются параметры:
Модуль оплаты Stripe от разработчика Dev2Fun использует следующие параметры для обработки ошибок и данных заказа.
Переменная &$error принимает строку или HTML-код для вывода сообщения об ошибке.
Переменная $errorText содержит текстовое описание ошибки.
Массив $arFields включает поля заказа, идентичные тем, что передаются в метод CSaleOrder::Update.
Переменная $orderID представляет идентификатор текущего заказа.
При возникновении замечаний или предложений по улучшению функционала модуля следует обращаться в службу технической поддержки.
Также доступна возможность выразить благодарность автору разработки.
Для «Платежный модуль Stripe» команда General iT может выполнить подключение, настройку и контрольную проверку после установки.