🌟 Платёжный модуль PayAnyWay для OpenCart v4.x

📦 Версия модуля: 1.0.2

ℹ️ Совместимость версий OpenCart: 4.0.0.0, 4.0.1.0, 4.0.1.1, 4.0.2.0, 4.0.2.1, 4.0.2.2, 4.0.2.3, 4.1.0.0, 4.1.0.1, 4.1.0.2, 4.1.0.3

ℹ️ Совместимость версий OpenCart "Русская сборка": 4.0.0.0, 4.0.1.0, 4.0.1.1, 4.0.2.1, 4.0.2.2, 4.0.2.3, 4.1.0.0

ℹ️ Примечание по валюте Данный модуль работает только с валютой RUB (Российский рубль). Перед активацией модуля убедитесь, что на сайте в качестве базовой валюты установлен RUB, либо у пользователя выбран счёт в RUB. Использование других валют не поддерживается.

🏗️ Структура модуля

├── admin
│   ├── controller/payment/payanyway.php
│   ├── language/{en-gb,ru-ru}/payment/payanyway.php
│   ├── view/image/payment/payanyway.png
│   └── view/template/payment/payanyway.twig
├── catalog
│   ├── controller/payment/
│   │              ├── callback.php
│   │              └── payanyway.php
│   ├── language/{en-gb,ru-ru}/payment/payanyway.php
│   ├── library/payanyway/traits/payanyway.php
│   ├── model/payment/payanyway.php
│   └── view/template/extension/payment/payanyway.twig
├── install.json
└── README.md

🚀 Установка и настройка модуля

1. 📥 Скачайте архив модуля и переименуйте в payanyway.ocmod.zip.
2. 📂 Загрузите расширение через панель управления интернет-магазином. В разделе "Модули / Расширения" выберите подраздел "Установка расширений". Нажмите "Загрузить" и выберите скачанный архив payanyway.ocmod.zip. В списке установленных расширений найдите PayAnyWay и нажмите "Установить".
3. ⚙️ В подразделе "Модули / Расширения" выберите тип расширения "Оплата". В списке способов оплаты найдите PayAnyWay и нажмите:
   • «Установить» — для установки модуля
   • «Редактировать» — для перехода к настройкам
4. ✏️ Заполните соответствующие поля в настройках способа оплаты:

Поле	Описание
Статус	Включите или выключите модуль оплаты
Номер счёта	Ван номер расширенного счёта в системе MONETA.RU
Код проверки целостности данных	Код проверки целостности данных, указанный в настройках расширенного счёта в системе MONETA.RU
Сервер платежей	Боевой / Тестовый
НДС	Выберите из списка
Валюта платежа	RUB
Статусы заказа	Выберите соответствующие статусы заказа из списка
Обрабатываемый	Укажите статус заказа, который выставляется при его создании
Успешный	Укажите статус заказа, который выставляется при успешной оплате
Неуспешный	Укажите статус заказа, который выставляется при ошибке оплаты
Регион отображения	Географическая зона, в которой будет отображаться способ оплаты
Порядок сортировки	Определяет порядок отображения платежного метода в списке методов оплаты при оформлении заказа. Чем меньше число, тем выше позиция в списке

---

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

1. 📝 Зарегистрируйтесь в платёжной системе PayAnyWay и заполните все необходимые данные. Дождитесь проверки аккаунта и создайте расширенный счет.

2. ⚙️ Заполните настройки расширенного счета (раздел «Мой счет» → «Управление счетами» → «Редактировать счет»):

Параметр	Значение
Тестовый режим	Нет
Check URL	https://your_site_name/index.php?route=extension/payanyway/payment/callback
Pay URL	https://your_site_name/index.php?route=extension/payanyway/payment/callback
HTTP method	GET
Можно переопределять настройки в URL	Да
Подпись формы оплаты обязательна	Да
Код проверки целостности данных	ваш_код (произвольный набор символов)
Success URL	Оставить пустым
Fail URL	Оставить пустым
InProgress URL	Необязательное поле. URL страницы магазина, куда должен попасть покупатель после успешного запроса на авторизацию средств, до подтверждения списания и зачисления средств. Поддерживается ограниченным количеством методов оплаты. Переход пользователя произойдет независимо от получения магазином средств и отчета о проведенной оплате
Return URL	Оставить пустым

⚠️ Важно! Для кириллического домена PayURL и CheckURL должны быть указаны в кодировке Punycode.

⚠️ Важно! В OpenCart 4 при возврате с сайта платежной системы (эквайринга) авторизация пользователя чаще всего слетает из-за конфликта cookie-атрибута SameSite. Для решения проблемы выполните следующие действия:

1. Изменение настроек сессии в панели управления OpenCart по умолчанию использует для кук параметр Lax или Strict, что вызывает разрыв сессии при возврате с внешнего сервера Настройки SameSite. Перейдите в административную панель сайта. Откройте Система (System) > Настройки (Settings) и отредактируйте ваш магазин.
2. Перейдите на вкладку Сервер (Server). Найдите настройку Сессионный файл Cookie (Session Samesite Cookie). Измените значение с Lax/Strict на None (Нет) (это разрешит отправку куки при переходе с другого сайта).

---

📚 Полезные ресурсы OpenCart

• OpenCart
• Документация
• Релизы

📚 Полезные ресурсы OpenCart "Русская сборка"

• Русская сборка OpenCart
• Документация и FAQ
• Форум поддержки

---

✅ Модуль настроен, приятных платежей! 💰🎉