Криптоплатежи для WHMCS
Приём криптовалюты по счетам WHMCS. Клиент нажимает Pay Now, платит на странице SnapEX Pay в USDT в сетях TRON, Ethereum, BSC и других или в других монетах с конвертацией в USDT, и счёт в WHMCS отмечается оплаченным автоматически.
Бесплатно. Версия 1.1.0.
Что умеет модуль
- Не нужно держать кошельки и ноды: деньги приходят на баланс мерчанта SnapEX Pay.
- Три независимых способа отметить счёт оплаченным: подписанный вебхук, возврат клиента со страницы оплаты и фоновая проверка при запусках cron WHMCS (каждый ожидающий платёж — не чаще раза в 10 минут, в течение 5 дней). Потерянный вебхук не оставит оплаченный счёт неоплаченным, и платёж никогда не зачтётся дважды.
- Мультивалютный WHMCS: при Convert To For Processing = USD счета по-прежнему учитываются в валюте клиента.
- Частичные платежи автоматически не зачитываются — они попадают в Gateway Log на проверку. Если настроен вебхук, туда же записываются деньги, пришедшие после закрытия счёта SnapEX Pay.
- Тестовый режим: тестовые счета подтверждаются сами, без реальных денег; пока он включён, кнопку оплаты видят только вошедшие администраторы, остальные клиенты видят пометку «test mode».
Установка
- Загрузите содержимое архива в корень 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 — комиссия SnapEX Pay и комиссия сети добавляются сверху. |
| Payment window, minutes | Сколько действует страница оплаты (1–1440, по умолчанию 60). Повторное нажатие Pay Now позже откроет новую. |
| Test mode | Тестовые счета; пока режим включён, кнопку оплаты видят только администраторы. После выключения тестовые платежи игнорируются. |
| Partner ID | Необязательно: Partner ID интегратора, который настроил модуль (реферальная программа SnapEX Pay). Оставьте пустым, если ставите сами. |
| API URL | Оставьте как есть. |
Вопросы
Что будет, если вебхук не дойдёт?
Счёт всё равно отметится оплаченным: модуль проверяет платёж и при возврате клиента со страницы оплаты, и при запусках cron WHMCS (каждый ожидающий платёж — не чаще раза в 10 минут, в течение 5 дней). Платёж никогда не зачтётся дважды.
Валюта WHMCS не USD — заработает?
Да. Установите в настройках шлюза Convert To For Processing = USD; счета по-прежнему учитываются в валюте клиента.
Что если клиент заплатил меньше суммы счёта?
Если клиент не доплатит вовремя, автоматически ничего не зачисляется. В Gateway Log появляется запись «Partial payment — review and apply manually» с полученной суммой.
Что если деньги пришли после закрытия счёта SnapEX Pay?
В WHMCS они автоматически не зачитываются. Если настроен вебхук, в Gateway Log появляется запись; деньги лежат на вашем балансе SnapEX Pay.
Можно проверить без реальных денег?
Да. Включите Test mode: тестовые счета подтверждаются сами, а пока режим включён, кнопку оплаты видят только вошедшие администраторы.
Где посмотреть, что сделал модуль?
В WHMCS: Billing → Gateway Log. Номер транзакции платежа — это ID счёта SnapEX Pay (inv_…).
Другие интеграции
Готовы принимать крипту?
Создайте аккаунт мерчанта, получите API-ключ и подключите модуль. 1% с платежа, без абонентской платы.