# 🌟 Платёжный модуль PayAnyWay для [WooCommerce](https://woocommerce.com/) ([WordPress](https://wordpress.org/))

![WooCommerce](https://img.shields.io/badge/WooCommerce-9.8.x%2B-0070C0?logo=php&logoColor=white)
![WordPress](https://img.shields.io/badge/WordPress-7.0.x%2B-0070C0?logo=php&logoColor=white)
![PHP](https://img.shields.io/badge/PHP-5.6%2B-purple)
![License](https://img.shields.io/badge/License-MIT-green)

> **📦 Версия модуля: 1.5.1**

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

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

```
.
├── payanyway/
│   ├── assets/
│   │   ├── css/paw-main.css
│   │   └── images/payanyway.png
│   ├── includes/settings/settings-paw.php
│   ├── block-support.php
│   ├── blocks.js
│   └── wc-payanyway.php
└── README.md
```

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

1. 📥 [Скачайте архив модуля](https://git.pub.moneta.ru/CMS/WordPress-WooCommerce/releases).
2. 📂 Загрузите плагин через панель управления интернет-магазином.
   Выберите раздел **"Плагины"** → **"Добавить плагин"**. Нажмите **"Загрузить плагин"**, выберите скачанный архив и нажмите **"Установить сейчас"**.
   Произойдёт установка плагина из загруженного архива. Далее нажмите **"Активировать плагин"**.
   В списке найдите плагин **"Монета | PayAnyWay"** и нажмите **"Активировать"**.
3. ⚙️ В разделе **"Платежи"** нажмите **"Включить"** для активации способа оплаты и нажмите **"Править"**.
4. ✏️ Заполните соответствующие поля в настройках способа оплаты:

| Поле                                | Описание                                                                                                                                                                                                |
|-------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Включить/Выключить**              | Включите или выключите модуль оплаты                                                                                                                                                                    |
| **Название**                        | `PayAnyWay`                                                                                                                                                                                             |
| **Номер счёта**                     | Ваш номер расширенного счёта в системе [MONETA.RU](https://moneta.ru/)                                                                                                                                  |
| **Код проверки целостности данных** | Код проверки целостности данных, указанный в настройках расширенного счёта в системе [MONETA.RU](https://moneta.ru/)                                                                                    |
| **Демо режим**                      | Включите, если используете [демо-площадку](https://demo.moneta.ru/)                                                                                                                                     |
| **Форма оплаты в iframe**           | Вместо перехода на платежную форму можно отображать её сразу на странице вашего магазина. В настройках Расширенного счета опцию "Target (возврат для iframe)" обязательно установите в значение: `_top` |
| **Отладка**                         | Включите или выключите логирование                                                                                                                                                                      |
| **Описание**                        | `Приём платежей банковскими картами, через СБП и Pay‑сервисы`                                                                                                                                           |
| **Инструкции**                      | `Оплата с помощью PayAnyWay`                                                                                                                                                                            |

5. Сохраните изменения
---

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

1. 📝 [Зарегистрируйтесь](https://payanyway.ru/partnerRegistration.htm) в платёжной системе PayAnyWay и заполните все необходимые данные. Дождитесь проверки аккаунта и создайте **расширенный счет**.

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

| Параметр                                 | Значение                                                                                                                 |
|------------------------------------------|--------------------------------------------------------------------------------------------------------------------------|
| **Тестовый режим**                       | `Нет`                                                                                                                    |
| **Check URL**                            | `https://your_site_name/?wc-api=wc_payanyway&payanyway=callback`                                                         |
| **Pay URL**                              | `https://your_site_name/?wc-api=wc_payanyway&payanyway=callback`                                                         |
| **HTTP метод (PayUrl, CheckUrl)**        | `GET`                                                                                                                    |
| **Код проверки целостности данных**      | `ваш_код` (произвольный набор символов)                                                                                  |
| **Подпись формы оплаты обязательна**     | `Да`                                                                                                                     |
| **Можно переопределять настройки в URL** | `Да`                                                                                                                     |
| **Success URL**                          | Оставить пустым                                                                                                          |
| **Fail URL**                             | Оставить пустым                                                                                                          |
| **InProgress URL**                       | Оставить пустым                                                                                                          |
| **Return URL**                           | Оставить пустым                                                                                                          |
| **Target (возврат для iframe)**          | Если хотите вместо перехода на платёжную форму отображать её сразу на странице вашего магазина выставьте значение `_top` |

> ⚠️ **Важно!** Для кириллического домена PayURL и CheckURL должны быть указаны в кодировке [Punycode](https://2ip.ru/punycode/).

3. Для фискализации чеков по 54-ФЗ настройте вашу кассу в сервисе https://kassa.payanyway.ru, в настройках Вашего расширенного счёта в системе [MONETA.RU](https://moneta.ru/)
   установите Pay URL: `https://kassa.payanyway.ru/index.php?do=invoicepayurl`, а в настройках кассы в https://kassa.payanyway.ru
   пропишите ссылку на Pay URL Вашего интернет-магазина. В этом случае будет пробиваться чек
   по 54-ФЗ через сервис **kassa.payanyway.ru**, а запрос на Pay URL магазина будет проходить транзитом через сервис
   **kassa.payanyway.ru**.
---

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

* [Официальный сайт WordPress](https://wordpress.org/)
* [Официальный сайт WooCommerce](http://www.woothemes.com/woocommerce/)
* [WooCommerce GitHub Repositories](https://woocommerce.github.io/)
* [Developer Resources](https://developer.wordpress.org/)
* [WooCommerce Developers Docs](https://developer.woocommerce.com/docs/)

---

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

> ⚠️ Рекомендуем сделать платёж на незначительную сумму — 11 руб., чтобы проверить интеграцию.