esas/cmsgate-woocommerce-hutkigrosh

CMSGate Hutkigrosh integration library

v1.17.1 2022-02-25 13:45 UTC

README

Данный модуль обеспечивает взаимодействие между интернет-магазином на базе CMS WordPress с модулем электронной комерции WooCommerce и сервисом платежей ХуткiГрош

Требования

  1. PHP 5.6 и выше
  2. Библиотека Curl

Инструкция по установке:

Автоматическая установка (через Wordpress Plugin Directory)

  1. Перейти на страницу Плагины > Добавить новый
  2. Введите в поиске Hutkigrosh
  3. Установите плагин
  4. Активируйте плагин
  5. Перейдите к настройке

Ручная установка

  1. Создайте резервную копию вашего магазина и базы данных
  2. Загрузите архив модуля woo-hutkigrosh-gateway с помощью Модули -> Установка расширений
  3. Через панель администратора Wordpress зайдите в меню Плагины > Добавить новый
  4. Нажмите Загрузить плагин
  5. Выберите загруженый в п2. архив модуля woocommerce-gateway-hutkigrosh.zip и установите
  6. Активируйте плагин в меню Плагины -> Установленные
  7. Перейдите к настройке

Инструкция по настройке

  1. Перейдите к настройке плагина через меню WooCommerce -> Настройки -> Платежи
  2. Укажите обязательные параметры
    • Логин интернет-магазина – логин в системе ХуткiГрош.
    • Пароль интернет-магазина – пароль в системе ХуткiГрош.
    • Уникальный идентификатор услуги ЕРИП – ID ЕРИП услуги
    • Код услуги – код услуги в деревер ЕРИП. Используется при генерации QR-кода
    • Sandbox - перевод модуля в тестовый режим работы. В этом режиме счета выставляются в тестовую систему wwww.trial.hgrosh.by
    • Email оповещение - включить информирование клиента по email при успешном выставлении счета (выполняется шлюзом Хуткiгрош)
    • Sms оповещение - включить информирование клиента по смс при успешном выставлении счета (выполняется шлюзом Хуткiгрош)
    • Путь в дереве ЕРИП - путь для оплаты счета в дереве ЕРИП, который будет показан клиенту после оформления заказа (например, Платежи > Магазин > Заказы)
    • Срок действия счета - как долго счет, будет доступен в ЕРИП для оплаты
    • Статус при выставлении счета - какой статус выставить заказу при успешном выставлении счета в ЕРИП (идентификатор существующего статуса из Магазин > Настройки > Статусы)
    • Статус при успешной оплате счета - какой статус выставить заказу при успешной оплате выставленного счета (идентификатор существующего статуса)
    • Статус при отмене оплаты счета - какой статус выставить заказу при отмене оплаты счета (идентификатор существующего статуса)
    • Статус при ошибке оплаты счета - какой статус выставить заказу при ошибке выставленния счета (идентификатор существующего статуса)
    • Секция "Инструкция" - если включена, то на итоговом экране клиенту будет доступна пошаговая инструкция по оплате счета в ЕРИП
    • Секция QR-code - если включена, то на итоговом экране клиенту будет доступна оплата счета по QR-коду
    • Секция Alfaclick - если включена, то на итоговом экране клиенту отобразится кнопка для выставления счета в Alfaclick
    • Секция Webpay - если включена, то на итоговом экране клиенту отобразится кнопка для оплаты счета картой (переход на Webpay)
    • Текст успешного выставления счета - текст, отображаемый кленту после успешного выставления счета. Может содержать html. В тексте допустимо ссылаться на переменные @order_id, @order_number, @order_total, @order_currency, @order_fullname, @order_phone, @order_address
    • Название способы оплаты - название, отображаемое клиенту, при выборе способа оплаты
    • Описание способа оплаты - описание, отображаемое клиенту, при выборе способа оплаты
  3. Сохраните изменения.

Внимание!

Для автоматического обновления статуса заказа (после оплаты клиентом выставленного в ЕРИП счета) необходимо сообщить в службу технической поддержки сервиса «Хуткi Грош» адрес обработчика следующим образом (где будет указан ваш домен):

http://mydomen.my/wordpress/?wc-api=gateway_hutkigrosh

Тестовые данные

Для настрой оплаты в тестовом режиме:

  • воспользуйтесь данными для подключения к тестовой системе, полученными при регистрации в ХуткiГрош
  • включите в настройках модуля режим "Песочницы"
  • для эмуляции оплаты клиентом выставленного счета воспльзуйтесь личным кабинетом тестовой системы (меню Тест оплаты ЕРИП)

Разработано и протестировано с Wordpress v5.3.2 и WooCommerce v4.0.1

Файлы логов

Логи модуля доступны по пути:

<wordpress home>/wp-content/plugins/woo-hutkigrosh-gateway/vendor/esas/cmsgate-core/logs/cmsgate.log