Для использования модуля оплаты Stripe необходимо выполнить настройки на стороне платежной системы и подключить модуль в BILLmanager.
| Поддержка способов оплаты | ||||
|---|---|---|---|---|
| Банковские карты | Наличные | Электронные кошельки | Мобильные платежи | Интернет-банкинг |
 |  | | | |
| American Express, Diners, Discover, JCB, Maestro, Mastercard, Union Pay. | ||||
| Поддерживаемые возможности | ||||
| Поддержка ФЗ-54 | | |||
| Возврат платежей | | |||
| Рекуррентные платежи | | |||
| Подписки | | |||
Настройка на стороне платежной системы
- Настройте 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-сертификат. - Включите оповещение клиентов о платежах, требующих подтверждения оплаты: раздел 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.
- Заполните название учётной записи в аккаунте Stripe: раздел Settings → Business settings → Your business → Account Information → поле Account name.
Настройка на стороне BILLmanager
Подключение модуля оплаты выполняется в разделе Провайдер → Методы оплаты. Мастер подключения состоит из трех шагов:
- Выбор метода оплаты. В качестве метода оплаты выберите "Stripe".
- Настройка интеграции. Ввод информации, необходимой для интеграции с платежной системой.
- Настройка метода оплаты. Настройка внутренних (в пределах BILLmanager) параметров метода оплаты.
Настройка интеграции
Настройка интеграции в BILLmanager
Опция Клиент в платежной системе предлагает использовать существующий аккаунт на стороне платёжной системы или создать новый. При выборе первого значения укажите данные для интеграции:
- Способ оплаты — способ оплаты, доступный клиентам.
- Secret Key — секретный ключ доступа к API в системе Stripe.
- Publishable Key — публичный ключ доступа к API в системе Stripe.
- URL логотипа — URL логотипа провайдера. Изображение будет размещено на странице оплаты услуг клиентом. Рекомендуемый размер — 150х50 точек.
- Рекуррентные платежи — опция включает использование рекуррентных платежей. При настройке автоплатежей со стороны клиента будет автоматически выполнен платеж в 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.