Модуль Qiwi

Назначение модуля

Модуль биллинга Qiwi предназначен для проведения платежей с использованием механизма выставления счетов и оплаты их с помощью кошелька в системе Qiwi. Для проведения платежей вашими абонентам у вас должен быть заключен договор с данной платежной системой.

Обратите внимание, что для приема платежей через терминалы Qiwi достаточно модуля MPS.

Настройка модуля

Установите модуль на сервер, обновите клиент. Затем создайте экземпляр модуля. Создайте в редакторе конфигурации модуля новую конфигурацию.

images/download/attachments/43385665/%D0%9F%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B.png

После этого сохраните конфигурацию и сделайте её активной.

Модуль поддерживает 2 протокола взаимодействия с платежной системой: soap (устарел) и rest. Настройка используемого протокола осуществляется в ЛК Qiwi, а также в конфигурации биллинга с помощью параметра qiwi.protocol.version.

Замечания:

  1. Прежде, чем задавать qiwi.payment.type.id, необходимо создать соответствующий тип платежа в Справочнике (Справочники->Другие->Типы платежей).

  2. Прежде, чем задавать qiwi.charge.type.id, необходимо создать соответствующий тип расхода в Справочнике (Справочники->Другие->Типы расходов). Обращаем внимание, что возврат платежей поддерживается только в протоколе REST!

  3. Номер транзакции создается следующим образом: берется ID транзакции из таблицы qiwi_transaction_<mid> и соединяется с шаблоном. Например: если шаблон "BG0000", а ID пусть будет 34, тогда номер транзакции, отсылаемый в Qiwi, будет иметь вид: BG0034.

  4. При использовании протокола SOAP. После заключения договора с системой необходимо зайти в свой личный кабинет провайдера на стороне Qiwi и в настройках подключения в разделе SOAP ввести адрес веб-сервиса на стороне биллинга, на который будет приходить информация по статусу счета. Этот адрес формируется следующим образом: http://<адрес_машины_биллинга>/bgbilling/qiwiexecuter/ru.bitel.bgbilling.modules.qiwi/<код_модуля_Qiwi>/IShopClientWS. Например, если у вас биллинг находится по адресу http://billing.example.com/bgbilling/ и модуль Qiwi имеет mid=16, то результирующий URL, который нужно ввести в личном кабинете, выглядит следующим образом: http://billing.example.com/bgbilling/qiwiexecuter/ru.bitel.bgbilling.modules.qiwi/16/IShopClientWS.

  5. При использовании протокола REST. В ЛК Qiwi в разделе настройки REST-протокола необходимо ввести URL для уведомлений, который выглядит следующим образом: http://<адрес_машины_биллинга>/bgbilling/qiwiexecuter/ rest/<код_модуля_Qiwi>

  6. При использовании протокола REST. Параметр qiwi.notification.password используется для авторизации запросов-уведомлений о состоянии транзакций.

  7. Проверка статуса транзакции, отмена и возврат поддерживаются только в протоколе REST!

  8. При использовании протокола REST параметр qiwi.shop.id соответсвует полю project_id в ЛК Qiwi.

Оплата через кошелек

Если у клиента подключен экземпляр модуля в дереве договора, то он может осуществлять оплату через свой Qiwi-кошелек, используя личный web-интерфейс.

В личном кабинете на странице отображается история платежей, совершенных клиентом:

images/download/attachments/43385665/qiwi_web.png

Над таблицей с историей платежей расположена форма для совершения нового платежа. Чтобы осуществить платеж, необходимо заполнить обязательные поля Сумма и Телефон. Далее необходимо нажать кнопку Оплатить и подтвердить. После подтверждения клиент попадает на страницу системы Qiwi, где ему необходимо авторизоваться и подтвердить созданный счет с помощью своего мобильного телефона.

В случае успеха, клиент будет перенаправлен на страницу, указанную в конфигурации модуля в параметре qiwi.success.url.

Мониторинг платежей

В клиенте билинга есть возможность отслеживать историю платежей по каждому абоненту. Для этого необходимо выбрать модуль Qiwi в дереве параметров договора. Здесь присутствует фильтр по статусу платежей (оплаченные, выставленные, проводимые, отмененные, все) с указанием периода, когда производилась оплата.

images/download/attachments/43385665/qiwi_client_1.png

Для просмотра ВСЕХ платежей, проведенных с использованием модуля Qiwi, существует глобальный монитор транзакций в параметрах данного модуля биллинга (Модули -> Модуль Qiwi). На открывшейся вкладке у Вас есть возможность просмотреть все платежи, совершенные вашими абонентами за указанный временной период. Также можно установить фильтр платежей по группам договоров, по имени договора, по статусу, а также по произвольному текстовому параметру договора, по которому можно идентифицировать договор (например, в параметре договора хранится ИНН абонента, его расчетный счет и т.п. ). В последнем случае код параметра договора задается в конфигурации модуля в опции qiwi.additional.identify.key.pid.

images/download/attachments/43385665/qiwi_client_2.png