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

Iyzico

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

Поддержка способов оплаты
Банковские картыНаличныеЭлектронные кошелькиМобильные платежиИнтернет-банкинг

Mastercard,
Visa,
Troy





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

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

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

Подписки

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

  1. Авторизуйтесь в личном кабинете Iyzico.
  2. Перейдите в раздел SettingsMerchant Settings.
  3. Скопируйте из секции API Keys данные API Key и Secret Key.
  4. В секции Merchant Notification:
    1. Включите уведомления о платежах.
    2. Укажите в поле Merchant Notification Url адрес в формате https://{BILLmanager_URL}/mancgi/iyzicowebhook.

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

Обратите внимание!
Установка модуля производится из последней доступной версии продукта и влечёт за собой обновление платформы BILLmanager, так как версия модуля не может быть выше версии платформы.

Платёжная система имеет обязательные поля для заполнения плательщиком. Чтобы создать отсутствующие поля, перейдите в раздел СправочникиСтраны → выберите страну → кнопка Параметры → кнопка Создать:

НаименованиеВнутреннее имя
email плательщикаemail
Имя плательщикаname
ИННvatnum
Городcity_physical
Странаcountry_physical_name
Адресaddress_physical

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

  1. Выбор метода оплаты. "Iyzico".
  2. Настройка интеграции. Укажите данные для интеграции:
    Выбор опции Создать нового отображает ссылку на форму регистрации в системе Iizico.
    Заполните форму, используя данные существующего клиента в платёжной системе:

    • URL API — если необходимо, укажите адрес API сервера. Вы можете оставить поле пустым, тогда будет использовано значение по умолчанию;
    • Ключ API — укажите API Key из личного кабинета платёжной системы;
    • Секретный ключ API — укажите Secret Key из личного кабинета платёжной системы;
    • Использовать 3D Secure — активируйте опцию, чтобы при оплате модуль запрашивал авторизацию через 3D Secure;
    • Разрешить возврат платежей — активируйте опцию, чтобы разрешить возврат платежей.

  3. Настройка метода оплаты. Настройка внутренних (в пределах BILLmanager) параметров метода оплаты.

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

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

Чтобы разрешить возврат платежей, перейдите в раздел Провайдер → Методы оплаты → кнопка Изменить → опция Разрешить возврат платежей. Возврат поддерживается для платежей со статусом "Зачислен".

Логирование

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

  • /usr/local/mgr5/var/pmiyzico.log — лог-файл настройки модуля оплаты, совершения возврата средств, проверки статусов платежей;
  • /usr/local/mgr5/var/iyzicopayment.log — лог-файл оплаты;
  • /usr/local/mgr5/var/iyzicowebhook.log — лог-файл обработки уведомлений от iyzico.