3
0

97 lines
10 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🌟 Платёжный модуль 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.2**
> ** Примечание по валюте**
> Данный модуль работает **только с валютой 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 руб., чтобы проверить интеграцию.