Документация BILLmanager 6

Stripe

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

Поддержка способов оплаты
Банковские картыНаличныеЭлектронные кошелькиМобильные платежиИнтернет-банкинг
American Express,
Diners,
Discover,
JCB,
Maestro,
Mastercard,
Union Pay.




Поддерживаемые возможности
Поддержка ФЗ-54

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

Рекуррентные платежи

Подписки

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

  1. Настройте webhook: раздел DevelopersWebhooks → кнопка Add endpoint. В качестве Endpoint URL укажите адрес CGI-скрипта биллинговой платформы. Например, "https://domain.com:1500/mancgi/stripewebhook". Для уведомлений включите события charge.succeeded, charge.failed, setup_intent.succeeded:
    Обратите внимание!
    Если в Endpoint URL указать протокол HTTPS, то платёжная система будет выполнять проверку безопасности соединения с указанным сервером. В этом случае для корректного взаимодействия со Stripe доменное имя сервера должно иметь действительный SSL-сертификат.
  2. Включите оповещение клиентов о платежах, требующих подтверждения оплаты: раздел SettingsStripe apps Billing Subscriptions and emails Manage payments that require 3D SecureCustomer emails → опция Send a Stripe-hosted link for cardholders to authenticate when required . Эта опция используется, когда клиент активирует рекуррентный платёж картой, требующей подтверждения каждой операции. При активации платежа на email клиента придёт письмо с инструкциями для подтверждения оплаты. После подтверждения платёж будет зачислен на стороне BILLmanager.
  3. Заполните название учётной записи в аккаунте Stripe: раздел SettingsBusiness settingsYour businessAccount Information → поле Account name.

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

Обратите внимание!
Установка модуля производится из последней доступной версии продукта и влечёт за собой обновление платформы 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.