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:

   

   Настройка webhook в Stripe

   

   Обратите внимание!

   Если в 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. Настройка интеграции. Ввод информации, необходимой для интеграции с платежной системой.
3. Настройка метода оплаты. Настройка внутренних (в пределах BILLmanager) параметров метода оплаты.

Настройка интеграции

Настройка интеграции в BILLmanager

Опция Клиент в платежной системе предлагает использовать существующий аккаунт на стороне платёжной системы или создать новый. При выборе первого значения укажите данные для интеграции:

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 или произвольную;

Выбор опции Создать нового отображает ссылку на форму регистрации в системе Stripe.

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

---

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

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

Логирование

Логи взаимодействия биллинговой системы со 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.