esas/cmsgate-joomshopping-epos

Joomla joomshopping to Epos (ERIP) cms payment gate library

v1.11.0 2020-07-16 10:50 UTC

This package is not auto-updated.

Last update: 2024-07-05 21:12:37 UTC


README

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

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

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

  1. Создайте резервную копию вашего магазина и базы данных
  2. Загрузите архив с модулем plg_jshopping_epos.zip
  3. В административной части Joomla выберите Расширения - Менеджер расширений - Установка - Загрузить Файл пакета. Выберите архив и нажмите Загрузить.
  4. Перейдите в меню Компоненты — JoomShopping - Опции - Способы оплаты.
  5. Выберите Epos, перейдите на вкладку "Конфигурация"
  6. Задайте параметры для модуля
    • EPOS процессинг - выбор организации, выполняющей интеграцию с EPOS
    • Идентификатор клиента – Ваш персональный логи для работы с сервисом EPOS
    • Секрет – Ваш секретный ключ для работы с сервисом EPOS
    • Код ПУ – код поставщика услуги в системе EPOS
    • Код услуги EPOS – код услуги у поставщика услуг в системе EPOS (один ПУ может предоставлять несколько разных услуг)
    • Код торговой точки – код торговой точки ПУ (у одного ПУ может быть несколько торговых точек)
    • Debug mode - запись и отображение дополнительных сообщений при работе модуля
    • Sandbox - перевод модуля в тестовый режим работы. В этом режиме счета выставляются в тестовую систему
    • Срок действия счета - как долго счет, будет доступен в ЕРИП для оплаты
    • Статус при выставлении счета - какой статус выставить заказу при успешном выставлении счета в ЕРИП (идентификатор существующего статуса из Магазин > Настройки > Статусы)
    • Статус при успешной оплате счета - какой статус выставить заказу при успешной оплате выставленного счета (идентификатор существующего статуса)
    • Статус при отмене оплаты счета - какой статус выставить заказу при отмене оплаты счета (идентификатор существующего статуса)
    • Статус при ошибке оплаты счета - какой статус выставить заказу при ошибке выставленния счета (идентификатор существующего статуса)
    • Секция "Инструкция" - если включена, то на итоговом экране клиенту будет доступна пошаговая инструкция по оплате счета в ЕРИП
    • Секция QR-code - если включена, то на итоговом экране клиенту будет доступна оплата счета по QR-коду
    • Секция 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=epos&task=notify
  • Модуль ведет лог файл по пути site_root/components/com_jshopping/payments/pm_epos/vendor/esas/cmsgate-core/logs/cmsgate.log Для обеспечения безопасности необходимо убедиться, что в настройках http-сервера включена директива AllowOverride All для корневой папки.

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

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

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

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

История версий

  • v1.10.0:
    • Исправление с автоматическим изменением статуса при оплате