С декабря 2020 г. платёжная система QIWI использует новый протокол приёма платежей для юридических лиц. В текущей реализации BILLmanager не поддерживает этот протокол. Поддержка старого протокола продолжается.
На текущий момент, интеграция с QIWI b2b (для юридических лиц) работает только для старых клиентов, ранее настроивших и продолжающих использовать данный метод.
Для использования модуля оплаты QIWI необходимо выполнить настройки на стороне платежной системы и подключить модуль в BILLmanager.
Настройка на стороне платёжной системы
В личном кабинете QIWI, в разделе Настройки → Протоколы:
- Включите уведомления.
- Укажите URL для оповещения: "https://<URL_BILLmanager>/mancgi/qiwiresult".
- Включите использование подписи.
- Загрузите сертификат, если на сервере с биллинговой платформой используется самоподписанный сертификат.
- Нажмите кнопку Сменить пароль оповещений, чтобы получить пароль оповещений.
- Убедитесь, что в настройках магазина, в разделе Настройки → Протоколы → HTTP-протокол активен протокол HTTP. Используется для переадресации на сайте b2b.qiwi.com.
- Убедитесь, что в настройках REST-протокола активен флаг Подпись.
Настройка на стороне BILLmanager
Чтобы создать модуль оплаты, перейдите в раздел Провайдер → Методы оплаты → кнопка Создать. Мастер подключения модуля оплаты состоит из следующих шагов:
- Выбор модуля оплаты: "QIWI".
- Настройка интеграции. Укажите данные для интеграции.
Активируйте опцию Создать нового клиента, чтобы отобразить ссылку для регистрации в платёжной системе.
Заполните форму, используя данные существующего клиента в платёжной системе:- API ID — уникальный идентификатор шлюза API-запросов в системе Visa QIWI Wallet.
- ID проекта — уникальный идентификатор проекта в системе Visa QIWI Wallet.
- Пароль к API — пароль доступа к API.
- Пароль оповещения — пароль оповещений из настроек протокола на стороне Visa QIWI Wallet.
- Настройка метода оплаты. Настройте внутренние (в пределах BILLmanager) параметры метода оплаты. Подробнее см. шаг 3 в статье Настройка методов оплаты.
Дополнительная информация
Возврат платежей
Для возврата платежей необходимо активировать соответствующий флаг в настройках метода оплаты: Провайдер → Методы оплаты → кнопка Изменить → флаг Разрешить возврат платежей. Возврат поддерживается для платежей со статусом "Зачислен".
Логирование
Логи взаимодействия биллинговой платформы с QIWI записываются в файлы:
- /usr/local/mgr5/var/pmqiwi.log — лог файл настройки модуля оплаты.
- /usr/local/mgr5/var/qiwipayment.log — лог файл оплаты.
- /usr/local/mgr5/var/qiwiresult.log — лог файл получения ответа от платёжной системы.