Плагин WHMCS

1. Требования

• WHMCS 8.13+ или 9.0 и публичный HTTPS System URL
• Аккаунт Paymos и выбранный в дашборде проект
• Официальный пакет со страницы GitHub Releases

Официальный пакет одинаков для всех мерчантов и не содержит API-ключей, API-секретов, ID проекта, секретов вебхуков, OAuth token или device code.

2. Установка

Распакуйте архив релиза в корень WHMCS, включите Paymos в «Конфигурация → Системные настройки → Платёжные шлюзы», затем нажмите «Подключить Paymos» на этой странице.

3. Подключение

1. Откройте в дашборде Paymos проект, который хотите подключить. Плагин автоматически использует текущий проект и больше не предлагает выбирать его.
2. Нажмите Подключить Paymos в WHMCS.
3. Подтвердите показанные URL магазина и текущий проект в Paymos. Второго выбора проекта нет.
4. Вернитесь в CMS после появления статуса подключения.

Для тестового и рабочего режима Paymos использует один активный платёжный ключ мерчанта или создаёт его при первом подключении. Вебхук счетов используется повторно только при полном совпадении адреса и проекта; при отличиях создаётся отдельный вебхук. Существующая конфигурация с тем же адресом не перезаписывается:

https://your-store.example/modules/gateways/callback/paymosgateway.php

OAuth device authorization используется только для одноразовой доставки ключей. Короткоживущий token удаляется; рабочие запросы Merchant API продолжают подписываться HMAC.

4. Хранение секретов

Ключи и временный device state хранятся в AES-256-GCM envelope в tblconfiguration; ключ выводится из installation encryption hash WHMCS. Сохранённые секреты не возвращаются в страницу администрирования.

5. Тест и запуск в продакшн

Выберите тестовый режим, оформите заказ и проверьте счёт и обновление статуса по вебхуку. Затем включите рабочий режим в той же установке. Повторное подключение требуется только после смены адреса магазина, отзыва платёжного ключа или ротации секрета вебхука.