110 lines
13 KiB
Markdown
110 lines
13 KiB
Markdown
# 🌟 Платёжный модуль PayAnyWay для [OpenCart](https://www.opencart.com/) v3.x
|
||
|
||

|
||

|
||

|
||
|
||
> **📦 Версия модуля: 1.0.1**
|
||
|
||
> **ℹ️ Совместимость версий OpenCart:**
|
||
> 3.0.0.0, 3.0.1.1, 3.0.1.2, 3.0.2.0, 3.0.3.0, 3.0.3.1, 3.0.3.2, 3.0.3.3, 3.0.3.4, 3.0.3.5, 3.0.3.6, 3.0.3.7, 3.0.3.8, 3.0.3.9, 3.0.4.0, 3.0.4.1, 3.0.5.0
|
||
|
||
> **ℹ️ Совместимость версий OpenCart "Русская сборка":**
|
||
> 3.0.0.1, 3.0.1.1, 3.0.1.2, 3.0.2.0, 3.0.3.0, 3.0.3.1, 3.0.3.2, 3.0.3.6, 3.0.3.7, 3.0.3.8, 3.0.3.9, 3.0.4.0, 3.0.4.1, 3.0.5.0
|
||
|
||
> **ℹ️ Совместимость версий ocStore:**
|
||
> 3.0.2.0, 3.0.3.7, 3.0.3.9
|
||
|
||
> **ℹ️ Примечание по валюте**
|
||
> Данный модуль работает **только с валютой RUB (Российский рубль)**.
|
||
> Перед активацией модуля убедитесь, что на сайте в качестве базовой валюты установлен RUB, либо у пользователя выбран счёт в RUB. Использование других валют не поддерживается.
|
||
|
||
## 🏗️ Структура модуля
|
||
|
||
```
|
||
├── upload
|
||
│ ├── admin
|
||
│ │ ├── controller/extension/payment/payanyway.php
|
||
│ │ ├── language/{en-gb,ru-ru}/extension/payment/payanyway.php
|
||
│ │ ├── view/image/payment/payanyway.png
|
||
│ │ └── view/template/extension/payment/payanyway.twig
|
||
│ └── catalog
|
||
│ ├── controller/extension/payment/payanyway.php
|
||
│ ├── language/{en-gb,ru-ru}/extension/payment/payanyway.php
|
||
│ ├── model/extension/payment/payanyway.php
|
||
│ └── view/theme/default/template/extension/payment/payanyway.twig
|
||
├── install.xml
|
||
└── README.md
|
||
```
|
||
|
||
## 🚀 Установка и настройка модуля
|
||
|
||
1. 📥 [Скачайте архив модуля](https://git.pub.moneta.ru/CMS/openCart3/releases) и переименуйте в `payanyway.ocmod.zip`.
|
||
2. 📂 Загрузите расширение через панель управления интернет-магазином.
|
||
Выберите раздел **"Модули / Расширения"** → **"Установка расширений"**. Нажмите "Загрузить" и выберите скачанный архив.
|
||
3. ⚙️ В разделе **"Модули / Расширения"** → **"Модули / Расширения"** выберите тип расширения **"Оплата"**.
|
||
В списке модулей оплаты найдите **PayAnyWay** и нажмите:
|
||
- **«Активировать»** — для включения модуля
|
||
- **«Редактировать»** — для перехода к настройкам
|
||
4. ✏️ Заполните соответствующие поля в настройках способа оплаты:
|
||
|
||
| Поле | Описание |
|
||
|-------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|
|
||
| **Включить модуль оплаты** | Включите или выключите модуль оплаты |
|
||
| **Номер счёта** | Ван номер расширенного счёта в системе [MONETA.RU](https://moneta.ru/) |
|
||
| **Код проверки целостности данных** | Код проверки целостности данных, указанный в настройках расширенного счёта в системе [MONETA.RU](https://moneta.ru/) |
|
||
| **Сервер платежей** | `Боевой` / `Тестовый` |
|
||
| **НДС** | Выберите из списка |
|
||
| **Валюта платежа** | `RUB` |
|
||
| **Статусы заказа** | Выберите соответствующие статусы заказа из списка |
|
||
| **Обрабатываемый** | Укажите статус заказа, который выставляется при его создании |
|
||
| **Успешный** | Укажите статус заказа, который выставляется при успешной оплате |
|
||
| **Неуспешный** | Укажите статус заказа, который выставляется при ошибке оплаты |
|
||
| **Регион отображения** | Географическая зона, в которой будет отображаться способ оплаты |
|
||
| **Порядок сортировки** | Определяет порядок отображения платежного метода в списке методов оплаты при оформлении заказа. Чем меньше число, тем выше позиция в списке |
|
||
|
||
---
|
||
|
||
## 🔧 Инструкция по настройке счета PayAnyWay
|
||
|
||
1. 📝 [Зарегистрируйтесь](https://payanyway.ru/partnerRegistration.htm) в платёжной системе PayAnyWay и заполните все необходимые данные. Дождитесь проверки аккаунта и создайте **расширенный счет**.
|
||
|
||
2. ⚙️ Заполните настройки расширенного счета (раздел **«Мой счет» → «Управление счетами» → «Редактировать счет»**):
|
||
|
||
| Параметр | Значение |
|
||
|------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||
| **Тестовый режим** | `Нет` |
|
||
| **Check URL** | `https://your_site_name/index.php?route=extension/payment/payanyway/callback` |
|
||
| **Pay URL** | `https://your_site_name/index.php?route=extension/payment/payanyway/callback` |
|
||
| **HTTP method** | `GET` / `POST` |
|
||
| **Можно переопределять настройки в URL** | `Да` |
|
||
| **Подпись формы оплаты обязательна** | `Да` |
|
||
| **Код проверки целостности данных** | `ваш_код` (произвольный набор символов) |
|
||
| **Success URL** | Оставить пустым |
|
||
| **Fail URL** | Оставить пустым |
|
||
| **InProgress URL** | Необязательное поле. URL страницы магазина, куда должен попасть покупатель после успешного запроса на авторизацию средств, до подтверждения списания и зачисления средств. Поддерживается ограниченным количеством методов оплаты. Переход пользователя произойдет независимо от получения магазином средств и отчета о проведенной оплате |
|
||
| **Return URL** | Оставить пустым |
|
||
|
||
> ⚠️ **Важно!** Для кириллического домена PayURL и CheckURL должны быть указаны в кодировке [Punycode](https://2ip.ru/punycode/).
|
||
|
||
---
|
||
|
||
## 📚 Полезные ресурсы OpenCart
|
||
|
||
* [OpenCart](https://www.opencart.com/)
|
||
* [Документация](https://docs.opencart.com/)
|
||
* [Релизы](https://github.com/opencart/opencart/releases)
|
||
|
||
## 📚 Полезные ресурсы OpenCart "Русская сборка"
|
||
|
||
* [Русская сборка OpenCart](https://opencart-russia.ru/)
|
||
* [Документация и FAQ](https://forum.opencart-russia.ru/forums/wiki/)
|
||
* [Форум поддержки](https://forum.opencart-russia.ru/)
|
||
|
||
## 📚 Полезные ресурсы OsStore
|
||
|
||
* [OsStore](https://ocstore.com/)
|
||
* [Форум поддержки](https://opencartforum.com/)
|
||
---
|
||
|
||
**✅ Модуль настроен, приятных платежей!** 💰🎉 |