esas/cmsgate-joomshopping-epos

Joomla joomshopping to Epos (ERIP) cms payment gate library

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

Requires

• php: >= 5.6.0
• ext-curl: *
• ext-openssl: *
• esas/cmsgate-epos-lib: ~v1.11.0
• esas/cmsgate-joomshopping-lib: ~v1.11.0

MIT

• esas

• api
• joomla
• payment gateway
• joomshopping
• erip
• cmsgate
• epos

README

Данный модуль обеспечивает взаимодействие между интернет-магазином на базе 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:
  • Исправление с автоматическим изменением статуса при оплате