Модуль интеграции ХуткiГрош с CMS Joomlal 3.x (с корзиной Joomshopping 4.x)
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
README.md
composer.json
plg_jshopping_hutkigrosh.zip
update.xml

README.md

Модуль интеграции с CMS Joomla 3.x (с корзиной Joomshopping 4.x)

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

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

  1. Создайте резервную копию вашего магазина и базы данных
  2. Загрузите архив с модулем plg_jshopping_hutkigrosh.zip
  3. В административной части Joomla выберите Расширения - Менеджер расширений - Установка - Загрузить Файл пакета. Выберите архив и нажмите Загрузить.
  4. Перейдите в меню Компоненты — JoomShopping - Опции - Способы оплаты.
  5. Выберите Hutkigrosh, перейдите на вкладку "Конфигурация"
  6. Задайте параметры для модуля
    • Логин интернет-магазина – логин в системе Хутк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
  7. Сохраните изменения.

Внимание!

  • Для автоматического обновления статуса заказа (после оплаты клиентом выставленного в ЕРИП счета) необходимо сообщить в службу технической поддержки сервиса «Хуткi Грош» адрес обработчика:
http://mydomen.my/index.php?option=com_jshopping&controller=hutkigrosh&task=notify
  • Модуль ведет лог файл по пути site_root/components/com_jshopping/payments/pm_hg/vendor/esas/hutkigrosh-api-php/logs/hutkigrosh.log Для обеспечения безопасности необходимо убедиться, что в настройках http-сервера включена директива AllowOverride All для корневой папки.

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

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

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

Разработано и протестировано с Joomla v.3.8.3 + Joomshopping v.4.16.3