Криптоплатежи для WHMCS
Приём криптовалюты по счетам WHMCS. Клиент нажимает Pay Now, платит на странице SnapEX Pay в USDT в сетях TRON, Ethereum, BSC и других или в других монетах с конвертацией в USDT, и счёт в WHMCS отмечается оплаченным автоматически.
Бесплатно. Версия 1.0.0.
Что умеет модуль
- Не нужно держать кошельки и ноды: деньги приходят на баланс мерчанта SnapEX Pay.
- Три независимых способа отметить счёт оплаченным: подписанный вебхук, возврат клиента со страницы оплаты и проверка при каждом запуске cron WHMCS. Потерянный вебхук не оставит оплаченный счёт неоплаченным, и платёж никогда не зачтётся дважды.
- Мультивалютный WHMCS: при Convert To For Processing = USD счета по-прежнему учитываются в валюте клиента.
- Частичные и лишние платежи не зачитываются вслепую — они попадают в Gateway Log на проверку.
- Тестовый режим: тестовые счета подтверждаются сами, без реальных денег; кнопку видят только вошедшие администраторы.
Установка
- Загрузите содержимое архива в корень WHMCS с сохранением путей:
modules/gateways/snapexpay.php,modules/gateways/snapexpay/,modules/gateways/callback/snapexpay.php,includes/hooks/snapexpay.php. - В админке WHMCS откройте System Settings → Payment Gateways → All Payment Gateways и включите SnapEX Pay (Crypto).
- В кабинете мерчанта SnapEX Pay создайте API-ключ с правами
invoices.readиinvoices.writeи вставьте его в поле API key. - Вебхук (рекомендуется): в кабинете укажите адрес
https://<ваш WHMCS>/modules/gateways/callback/snapexpay.php(точный адрес WHMCS показывает под полем) и вставьте секретwhsec_…в поле Webhook secret. - Если валюта WHMCS не USD, установите Convert To For Processing = USD. Счета по-прежнему учитываются в валюте клиента.
- Включите Test mode, откройте неоплаченный счёт под администратором, оплатите его тестовым методом на странице SnapEX Pay и проверьте, что он стал Paid. Затем выключите тестовый режим.
Настройки
| API key | Из кабинета SnapEX Pay. |
|---|---|
| Webhook secret | whsec_… из настроек вебхука в кабинете. Без него модуль работает через страницу возврата и cron. |
| Network fee paid by | Merchant — клиент платит ровно сумму счёта. Client — комиссия сети добавляется сверху. |
| Payment window, minutes | Сколько действует страница оплаты (1–1440, по умолчанию 60). Повторное нажатие Pay Now позже откроет новую. |
| Test mode | Тестовые счета, только для администраторов. После выключения тестовые платежи игнорируются. |
Вопросы
Что будет, если вебхук не дойдёт?
Счёт всё равно отметится оплаченным: модуль проверяет платёж и при возврате клиента со страницы оплаты, и при каждом запуске cron WHMCS. Платёж никогда не зачтётся дважды.
Валюта WHMCS не USD — заработает?
Да. Установите в настройках шлюза Convert To For Processing = USD; счета по-прежнему учитываются в валюте клиента.
Что если клиент заплатил меньше суммы счёта?
Если клиент не доплатит вовремя, автоматически ничего не зачисляется. В Gateway Log появляется запись «Partial payment — review and apply manually» с полученной суммой.
Что если клиент заплатил после закрытия счёта?
В Gateway Log появляется запись, а деньги лежат на вашем балансе SnapEX Pay.
Можно проверить без реальных денег?
Да. Включите Test mode: тестовые счета подтверждаются сами, а кнопку оплаты видят только вошедшие администраторы.
Где посмотреть, что сделал модуль?
В WHMCS: Billing → Gateway Log. Номер транзакции платежа — это ID счёта SnapEX Pay (inv_…).
Другие интеграции
Готовы принимать крипту?
Создайте аккаунт мерчанта, получите API-ключ и подключите модуль. 1% с платежа, без абонентской платы.