# 🌟 Платёжный модуль PayAnyWay для WHMCS


![WHMCS](https://img.shields.io/badge/WHMCS-Gateway%20Module-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)

**[WHMCS (Web Host Manager Complete Solution)](https://www.whmcs.com/)** — это универсальная платформа для автоматизации хостингового бизнеса. Она предназначена для управления клиентами, биллингом, технической поддержкой и другими аспектами, связанными с предоставлением IT-услуг.
WHMCS предоставляет мощный функционал, который позволяет интегрировать различные панели управления, платежные системы и сервисы, делая процесс управления хостингом простым и удобным.

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

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

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

```
└── modules
    └── gateways
        ├── callback
        │   └── payanyway.php
        └── payanyway.php
```

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

1. 📥 [Скачайте архив модуля](https://www.payanyway.ru/info/public/cms/whmcs.zip) и распакуйте его.
2. 📂 Скопируйте содержимое архива в корень сайта.
3. ⚙️ В списке модулей оплаты WHMCS найдите **PayAnyWay** и активируйте его.
4. ✏️ Заполните соответствующие поля в настройках способа оплаты:

| Поле | Значение |
|------|----------|
| **Show on Order Form** | ✅ Поставить галочку |
| **Display Name** | `PayAnyWay` |
| **Account Number** | Номер расширенного счета в PayAnyWay (Moneta) |
| **Code of data integrity verification** | Код проверки целостности данных из настроек расширенного счета |
| **Test Mode** | ❌ Галочку **не** ставить |

---

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

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

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

| Параметр | Значение |
|----------|----------|
| **Тестовый режим** | `Нет` |
| **Check URL** | `https://your_site_name/modules/gateways/callback/payanyway.php` |
| **Pay URL** | `https://your_site_name/modules/gateways/callback/payanyway.php` |
| **HTTP method** | `GET` / `POST` |
| **Проверить Check/Pay URL** | `Нет` |
| **Можно переопределять настройки в URL** | `Да` |
| **Подпись формы оплаты обязательна** | `Да` |
| **Код проверки целостности данных** | `ваш_код` (произвольный набор символов) |
| **Success URL** | Оставить пустым |
| **Fail URL** | Оставить пустым |
| **InProgress URL** | Оставить пустым |
| **Return URL** | Оставить пустым |

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

---

## 🔌 Реализованные функции WHMCS

| Функция | Назначение |
|---------|------------|
| `payanyway_MetaData()` | Возвращает метаданные модуля (название, версию API, настройки) |
| `payanyway_config()` | Определяет поля конфигурации в панели администратора |
| `payanyway_link()` | Отображает кнопку оплаты и информационное сообщение на странице счета |

---

## 📖 Документация WHMCS

Ознакомьтесь с руководством по установке и настройке [WHMCS Panel](https://help.whmcs.com/m/setup/l/1075240-configuring-your-first-payment-gateway)

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

* [WHMCS: Developer Documentation](https://developers.whmcs.com/)
* [WHMCS: API Documentation](https://developers.whmcs.com/api/)
* [WHMCS: Payment Gateways](https://developers.whmcs.com/payment-gateways/)

---

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