91 lines
5.5 KiB
Markdown
91 lines
5.5 KiB
Markdown
# 🌟 Платёжный модуль PayAnyWay для WHMCS
|
||
|
||
|
||
|
||
|
||
|
||
|
||
**[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/)
|
||
|
||
---
|
||
|
||
**✅ Модуль настроен, приятных платежей!** 💰🎉 |