esas/cmsgate-woocommerce-hutkigrosh

CMSGate Hutkigrosh integration library

v2.0.5 2024-06-18 13:46 UTC

Requires

• php: >= 5.6.0
• ext-curl: *
• ext-json: *
• ext-mbstring: *
• esas/cmsgate-core: ~v2.2.11
• tecnickcom/tc-lib-barcode: 1.15.12

MIT

• Esas

• api
• payment gateway
• hutkigrosh
• esas
• cmsgate

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