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

QIWI

Обратите внимание!
С декабря 2020 г. платёжная система QIWI вводит новый протокол приёма платежей для юридических лиц. В текущей реализации BILLmanager не поддерживает этот протокол. Поддержка старого протокола продолжается.

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

Поддержка способов оплаты
Банковские картыНаличныеЭлектронные кошелькиМобильные платежиИнтернет-банкинг
Mastercard,
Visa,
Мир.
Терминалы
QIWI,
салоны связи,
отделения банков,
система CONTACT.
QIWI Wallet.Билайн,
Мегафон,
МТС,
Теле2.
Альфа-Клик,
ВТБ,
Промсвязьбанк,
Тинькофф и др.
Поддерживаемые возможности
Поддержка ФЗ-54
Возврат платежей
Рекуррентные платежи
Подписки

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

В личном кабинете QIWI, в разделе НастройкиПротоколы необходимо:

  • Включить уведомления. 
  • Указать URL для оповещения: "https://<URL_BILLmanager>/mancgi/qiwiresult"
  • Включить использование подписи.
  • Загрузить сертификат, если на сервере с биллинговой системой используется самоподписанный сертификат. 
  • Нажать кнопку Сменить пароль оповещений, чтобы  получить пароль оповещений. 
  • Убедиться, что в настройках магазина, в разделе НастройкиПротоколыHTTP-протокол активен протокол HTTP. Используется для переадресации на сайте b2b.qiwi.com
  • Убедиться, что в настройках REST-протокола активен флаг Подпись

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

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

  • Шаг 1. Выбор метода оплаты. В качестве метода оплаты необходимо выбрать "QIWI".
  • Шаг 2. Настройка интеграции. Ввод информации, необходимой для интеграции с платежной системой.
  • Шаг 3. Настройка метода оплаты. Настройка внутренних (в пределах BILLmanager) параметров метода оплаты.

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

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

API ID — уникальный идентификатор шлюза API-запросов в системе Visa QIWI Wallet. 

ID проекта — униакльный идентификатор проекта в системе Visa QIWI Wallet.

Пароль к API — пароль доступа к API. 

Пароль оповещения — пароль оповещений из настроек протокола на стороне Visa QIWI Wallet. 

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

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

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

Для возврата платежей необходимо активировать соответствующий флаг в настройках метода оплаты: Провайдер Методы оплаты → кнопка Изменить флаг Разрешить возврат платежей. Возврат поддерживается для платежей со статусом "Зачислен". 

Логирование

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

  • '/usr/local/mgr5/var/pmqiwi.log' — лог файл настройки модуля оплаты.
  • '/usr/local/mgr5/var/qiwipayment.log' — лог файл оплаты.
  • '/usr/local/mgr5/var/qiwiresult.log' — лог файл получения ответа от платежной системы.