Stripe

Для использования модуля оплаты Stripe выполните настройку на стороне платёжной системы и подключите модуль в BILLmanager.

Настройка на стороне платежной системы

1. Настройте webhook: раздел Developers → Webhooks → кнопка Add endpoint. В качестве Endpoint URL укажите адрес CGI-скрипта биллинговой платформы. Например, "https://domain.com:1500/mancgi/stripewebhook". Для уведомлений включите события charge.succeeded, charge.failed, setup_intent.succeeded:
   Обратите внимание!

   Если в Endpoint URL указать протокол HTTPS, то платёжная система будет выполнять проверку безопасности соединения с указанным сервером. В этом случае для корректного взаимодействия со Stripe доменное имя сервера должно иметь действительный SSL-сертификат.
2. Включите оповещение клиентов о платежах, требующих подтверждения оплаты: раздел Settings → Stripe apps → Billing → Subscriptions and emails → Manage payments that require 3D Secure → Customer emails → опция Send a Stripe-hosted link for cardholders to authenticate when required . Эта опция используется, когда клиент активирует рекуррентный платёж картой, требующей подтверждения каждой операции. При активации платежа на email клиента придёт письмо с инструкциями для подтверждения оплаты. После подтверждения платёж будет зачислен на стороне BILLmanager.
3. Заполните название учётной записи в аккаунте Stripe: раздел Settings → Business settings → Your business → Account Information → поле Account name.

Настройка на стороне BILLmanager

Чтобы создать модуль оплаты, перейдите в раздел Провайдер → Методы оплаты → кнопка Создать. Мастер подключения модуля оплаты состоит из следующих шагов:

1. Выбор модуля оплаты: "Stripe".
2. Настройка интеграции. Укажите данные для интеграции.
   Активируйте опцию Создать нового клиента, чтобы отобразить ссылку для регистрации в платёжной системе.
   Заполните форму, используя данные существующего клиента в платёжной системе:
   1. Способ оплаты — способ оплаты, доступный клиентам.
   2. Secret Key — секретный ключ доступа к API в системе Stripe.
   3. Publishable Key — публичный ключ доступа к API в системе Stripe.
   4. URL логотипа — URL логотипа провайдера. Изображение будет размещено на странице оплаты услуг клиентом. Рекомендуемый размер — 150х50 точек.
   5. Рекуррентные платежи — опция включает использование рекуррентных платежей. При настройке автоплатежей со стороны клиента будет автоматически выполнен платеж в 1 рубль. Это необходимо для подтверждения работоспособности банковской карты. По завершении процедуры активации рекуррентного платежа он будет отменен. Рекуррентные платежи Stripe в BILLmanager используются для автоматического пополнения лицевого счёта.
      
      • Страница возврата при успешном автоплатеже — ссылка для возврата из личного кабинета Stripe после успешной настройки автоплатежа. Используйте страницу BILLmanager https://domain.com/billmgr?func=payment.recurring.success или произвольную;
      • Страница возврата при неудачном автоплатеже — ссылка для возврата из личного кабинета Stripe после неудачной настройки автоплатежа. Используйте страницу BILLmanager https://domain.com/billmgr?func=payment.recurring.fail или произвольную.
3. Настройка метода оплаты. Настройте внутренние (в пределах BILLmanager) параметры метода оплаты. Подробнее см. шаг 3 в статье Настройка методов оплаты.

Дополнительная информация

Возврат платежей

Чтобы разрешить возврат платежей, перейдите в раздел Провайдер → Методы оплаты → кнопка Изменить → опция Разрешить возврат платежей. Возврат поддерживается для платежей со статусом "Зачислен".

Логирование

Логи взаимодействия биллинговой платформы со Stripe записываются в файлы:

• /usr/local/mgr5/var/pmstripe.log — настройка модуля оплаты, возврата и автоматического платежа;
• /usr/local/mgr5/var/stripepayment.log — форма оплаты;
• /usr/local/mgr5/var/striperesult.log — зачисление платежа;
• /usr/local/mgr5/var/striperecurring.log — форма активации автоплатежа;
• /usr/local/mgr5/var/stripesubscription.log — настройка автоплатежа;
• /usr/local/mgr5/var/stripewebhook.log — webhook.