Перейти к содержимому
ВойтиРегистрация

Принимайте криптоплатежи по счетам WHMCS

Достаточно аккаунта Cryptonly и API-ключа. Установите плагин - и счета WHMCS можно оплачивать криптовалютой. Ниже весь процесс настройки.

Как начать принимать криптоплатежи в WHMCS

  1. Зарегистрируйте аккаунт Cryptonly

    Создайте мерчант-аккаунт в панели Cryptonly. Этот аккаунт выдаёт API-ключ, идентификатор аккаунта и ключ подписи вебхука, которые нужны в шагах ниже.

  2. Создайте API-ключ

    Создайте ключ в Settings → Security → API keys со скоупами accounts.list, invoices.create и invoices.list. Скопируйте идентификатор аккаунта в Accounts и ключ подписи вебхука в Settings → Security. Сохранение шлюза без этого ключа подписи блокируется.

  3. Установите модуль WHMCS

    Скачайте шлюз с маркетплейса WHMCS и загрузите папку modules в корень WHMCS, чтобы она слилась с существующим каталогом modules. Активируйте Cryptonly в Setup → Payments → Payment Gateways. Пути загрузки и поля шлюза описаны в руководстве по интеграции WHMCS.

  4. Сохраните настройки шлюза

    Откройте Setup → Payments → Payment Gateways → Cryptonly → Manage Existing Gateway. Укажите отображаемое имя, API-ключ, идентификатор аккаунта и ключ подписи вебхука, затем сохраните. Модуль проверяет ключ и идентификатор аккаунта через GET /accounts, прежде чем записать их.

  5. Принимайте оплату по счетам

    Укажите публичный HTTPS-адрес в System URL: Setup → General Settings, чтобы Cryptonly мог достучаться до callback. На счёте клиент платит на hosted-странице. Подписанный вебхук invoice.statusChanged отмечает счёт оплаченным или записывает частичную оплату и оставляет остаток открытым.

    {systemurl}modules/gateways/callback/cryptonly.php

Что такое WHMCS

WHMCS — биллинговая система для хостинг-компаний, продавцов доменов и агентств. Она выставляет счета, ведёт регулярные платежи и записывает каждую оплату на аккаунт клиента.

Способ оплаты — это модуль шлюза. Его загружают в modules/gateways, включают в Payment Gateways, и клиент видит его при оплате счёта.

Cryptonly использует этот хук шлюза. Суммы счетов остаются в валюте биллинга. Клиент платит на странице Cryptonly, а подписанный вебхук проводит оплату в WHMCS, когда средства зачисляются.

Какую криптовалюту можно принимать в WHMCS с Cryptonly?

Все валюты
BitcoinBTC84 162,01 $+1,29%EthereumETH2 564,53 $+2,24%TetherUSDT0,998971 $-0,01%USD CoinUSDC1,001 $+0,01%BNBBNB754,11 $+0,73%TRONTRX0,3325 $+0,58%ChainlinkLINK13,445 $+3,84%

Вопросы о WHMCS

  • Какие версии WHMCS поддерживает модуль?

    WHMCS 8.0 или новее на PHP 7.4 или новее. Модуль проверен на WHMCS 9.0.5 и PHP 8.2.

  • Нужно ли собирать свою страницу крипто-оплаты?

    Нет. Клиент платит на hosted-странице Cryptonly и возвращается к счёту. Экран кошелька и слежение за сетью делать не нужно.

  • Сколько это стоит?

    0,5% с каждого платежа, без платы за подключение.

  • Можно ли проверить модуль до реальных платежей?

    Да. В режиме песочницы проходят и hosted-страница, и вебхук, но деньги не двигаются. Песочницу выключают и переключают ключи на боевые, когда биллинг готов принимать живые платежи.

  • Суммы счетов должны быть в криптовалюте?

    Нет. Счета остаются в валюте биллинга. Cryptonly пересчитывает сумму в момент оплаты.

  • Как WHMCS узнаёт, что счёт оплачен?

    Cryptonly отправляет подписанный вебхук invoice.statusChanged на modules/gateways/callback/cryptonly.php. Статусы paid и overpaid закрывают остаток. Частичная оплата проводится, а счёт остаётся открытым.

Принимайте криптоплатежи с WHMCS и Cryptonly

Hosted checkout, подписанные вебхуки и комиссия 0,5%. WHMCS сама обновляет статус счёта, а суммы остаются в фиате.