esas/cmsgate-opencart-hutkigrosh

Opencart cms payment gate library

v4.1.1 2020-05-01 06:55 UTC

Requires

• php: >= 5.6.0
• esas/cmsgate-core: >=v1.8.1 <1.9
• esas/cmsgate-hutkigrosh-lib: ~v1.8.0
• esas/cmsgate-opencart-lib: ~v1.8.0

MIT

• Esas

• api
• payment gateway
• opencart
• esas
• cmsgate

README

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

• Модуль интеграции для версии OpenCart 1.5.x
• Модуль интеграции для версии OpenCart 2.1.x
• Модуль интеграции для версии OpenCart 2.2.x

Требования

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

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

1. Создайте резервную копию вашего магазина и базы данных
2. Установите модуль cmsgate-opencart-hutkigrosh.ocmod.zip с помощью Модули -> Установка расширений
3. Напротив модуля ХуткiГрош нажмите «Установить»

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

1. Перейдите к настройке плагина через меню Модули -> Платежи
2. Напротив модуля ХуткiГрош нажмите «Изменить».
3. Укажите обязательные параметры
   • Логин интернет-магазина – логин в системе Хутк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
4. Сохраните изменения.

Внимание!

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

  http://mydomen.my/index.php?route=payment/hutkigrosh/notify
  

  • Для версии oc >2.3

  http://mydomen.my/index.php?route=extension/payment/hutkigrosh/notify
  

• Модуль ведет лог файл по пути site_root/upload/system/library/esas/cmsgate/hutkigrosh/vendor/esas/cmsgate-core/logs/cmsgate.log Для обеспечения безопасности необходимо убедиться, что в настройках http-сервера включена директива AllowOverride All для корневой папки.

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

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

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

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

• при сборке cmsgate-opencart-hutkigrosh.ocmod.zip (для OpenCart > v2.3) необходимо удалить каталоги
  • upload\admin\controller\payment
  • upload\admin\view\template\payment
  • upload\catalog\controller\payment
  • upload\catalog\model\payment
  • upload\catalog\view\theme\payment
• при сборке cmsgate-opencart21-hutkigrosh.ocmod.zip (для OpenCart v2.1) необходимо удалить каталоги
  • upload\admin\controller\extension\payment
  • upload\admin\view\template\extension\payment
  • upload\catalog\controller\extension\payment
  • upload\catalog\model\extension\payment
  • upload\catalog\view\theme\default\template\extension\payment