esas/cmsgate-woocommerce-epos

Wordpress Woocommerce to EPOS integration library

v1.10.0 2020-06-04 09:56 UTC

This package is not auto-updated.

Last update: 2024-04-12 20:04:13 UTC


README

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

Требования

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

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

Автоматическая установка (через Wordpress Plugin Directory)

  1. Перейти на страницу Плагины > Добавить новый
  2. Введите в поиске EPOS
  3. Установите плагин
  4. Активируйте плагин
  5. Перейдите к настройке

Ручная установка

  1. Создайте резервную копию вашего магазина и базы данных
  2. Загрузите архив модуля epos-gateway-for-woocommerce.zip с помощью Модули -> Установка расширений
  3. Через панель администратора Wordpress зайдите в меню Плагины > Добавить новый
  4. Нажмите Загрузить плагин
  5. Выберите загруженый в п2. архив модуля wc-epos-gateway.zip и установите
  6. Активируйте плагин в меню Плагины -> Установленные
  7. Перейдите к настройке

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

  1. Перейдите к настройке плагина через меню WooCommerce -> Настройки -> Платежи
  2. Укажите обязательные параметры
    • 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
    • Название способа оплаты - название, показываемое клиенту при оформлении заказа на этапе выбора способы оплаты заказа
    • Описание способа оплаты - название, показываемое клиенту при оформлении заказа на этапе выбора способы оплаты заказа
  3. Сохраните изменения.

Внимание!

Для автоматического обновления статуса заказа (после оплаты клиентом выставленного в ЕРИП счета) необходимо сообщить в службу технической поддержки сервиса EPOS адрес обработчика следующим образом (где будет указан ваш домен):

http://mydomen.my/wordpress/?wc-api=gateway_epos

Разработано и протестировано с Wordpress v6.0 и WooCommerce v6.6.0

Файлы логов

Логи модуля доступны по пути:

<wordpress home>/wp-content/plugins/woo-epos-gateway/vendor/esas/cmsgate-core/logs/cmsgate.log

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

  • v1.1.1:
    • Исправление с включением/отключением модуля в настройках
  • v1.10.0:
    • Исправление с автоматическим изменением статуса при оплате
  • v1.14.0:
    • Обновление cmsgate-core до версии 1.17
    • Белый фон для QR-code