Приём криптоплатежей для хостинга: WHMCS, BILLmanager, Blesta, WISECP, FOSSBilling, Paymenter и RootPanel

Эта инструкция — для хостинга, VPS-провайдера или реселлера, который выставляет счета в биллинге и хочет принимать за них криптовалюту. Задача не только получить деньги, но и чтобы счёт сам стал оплаченным: тогда биллинг продлит или запустит услугу как обычно, без ручной сверки переводов.

Зачем крипта: клиенты хостинга приходят из разных стран, и не у каждого есть карта, которую примет ваш эквайринг. SnapEX Pay не требует KYC ни от вас, ни от ваших клиентов и не ограничивает страны. Правила приёма криптовалюты в разных странах разные — уточните у юриста, как они касаются вашего бизнеса.

• 7биллингов с готовым модулем — все модули бесплатные
• 1%комиссия с платежа, без абонентской платы и платы за подключение
• 70+монет на странице оплаты, USDT — в TRON, Ethereum, BSC, Solana, TON и других сетях, вам всё приходит в USDT

Как оплачивается счёт хостинга

От неоплаченного счёта до продлённой услуги

Счёт в биллингеклиент выбирает SnapEX Pay

Страница оплатыUSDT или другая монета

Вебхукподпись HMAC-SHA256

Проверкамодуль перечитывает счёт в API

Счёт оплачендальше работает автоматика биллинга

Модуль не верит одному телу вебхука: перед тем как отметить счёт, он запрашивает его в API SnapEX Pay. Один и тот же платёж никогда не зачитывается дважды, даже если уведомление пришло повторно.

Шаг 1. Выберите модуль под свой биллинг

• Шлюз

  WHMCS

  Кнопка Pay Now ведёт на страницу оплаты, счёт становится Paid сам. Мультивалютные счета учитываются в валюте клиента.

  WHMCS 8.x и 9.x · PHP 7.4+ с cURL

• Метод оплаты

  BILLmanager

  Ставится скриптом install.sh, добавляет страховочную проверку платежей раз в 5 минут. Ключ проверяется при сохранении.

  BILLmanager 6, любая редакция · python3 3.6+

• Шлюз

  Blesta

  Счета в любой валюте: сумма пересчитывается в USD по курсам Blesta, транзакция пишется в валюте счёта.

  Blesta 6.x · PHP с cURL

• Шлюз

  WISECP

  Клиент, вернувшийся раньше подтверждения, видит страницу статуса — она сама переходит на «платёж успешен». Админка на английском, турецком и русском.

  WISECP 3 и 5 · PHP 8.1+, для WISECP 5 — 8.2

• Адаптер

  FOSSBilling

  Один файл в library/Payment/Adapter, появляется в System → Payment gateways.

  FOSSBilling 0.8+ · PHP 8.0+ · HTTPS

• Расширение

  Paymenter

  Нативный шлюз Paymenter v1: папка в extensions/Gateways, в Docker-образе — в /app/extensions.

  Paymenter v1.x · PHP 8.3+ · HTTPS

• Встроен

  RootPanel

  Модуль SnapEX Pay уже есть в биллинге RootPanel: добавьте платёжную систему и вставьте ключ и секрет вебхука.

  Инструкция — на сайте RootPanel

• API

  Свой биллинг

  Счёт создаётся одним запросом к REST API, в ответе — ссылка на страницу оплаты. О статусе сообщает подписанный вебхук.

  Документация и тестовый режим — те же, что у модулей

Шаг 2. Заведите аккаунт мерчанта и API-ключ

• Зарегистрируйтесь на pay.snapex.pro. Аккаунт обменника snapex.pro подходит — это один аккаунт. Документы не нужны.
• Создайте API-ключ с правами invoices.read и invoices.write.
• Добавьте адрес вебхука — его показывает сам модуль в настройках шлюза. Секрет подписи whsec_… показывается один раз, сразу вставьте его в поле Webhook secret.
• Каждое уведомление подписано HMAC-SHA256 с меткой времени. Если ваш сервер не ответил, SnapEX Pay повторит доставку — всего до 5 попыток.

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

Скачайте архив со страницы модуля и разложите файлы с сохранением путей:

• WHMCS: архив — в корень WHMCS, затем System Settings → Payment Gateways → All Payment Gateways → включить SnapEX Pay (Crypto).
• BILLmanager: под root распакуйте архив и выполните sh install.sh, затем Provider → Payment methods → Add → SnapEX Pay (crypto), валюта — USD.
• Blesta: архив — в корень, Settings → Payment Gateways → Available → Install. В Accepted Currencies отметьте USD и все валюты ваших счетов — иначе в счетах этой валюты клиент не увидит SnapEX Pay.
• WISECP: архив — в корень с путём coremio/modules/Payment/SnapexPay/, включите модуль в настройках платёжных шлюзов.
• FOSSBilling и Paymenter: файл или папку модуля — в каталог адаптеров, затем установите шлюз в админке. Если шлюз Paymenter не появился, выполните composer dump-autoload -o и php artisan optimize:clear.
• RootPanel: добавьте платёжную систему «SnapEX Pay», вебхук — https://ваш_домен/_rootpay/snapexpay/online.php.

Для Blesta вебхук обязателен: у Blesta нет cron для шлюзов, и без уведомления платёж запишется, только когда клиент вернётся со страницы оплаты.

Шаг 4. Проверьте оплату на тестовом счёте

Включите тестовый режим в настройках шлюза (в Paymenter — Environment = test) и оплатите неоплаченный счёт тестовым методом на странице SnapEX Pay. Тестовый счёт подтверждается сам, реальные деньги не двигаются. Обычные клиенты в это время кнопку не видят: в WHMCS и WISECP её видит только вошедший администратор, в Blesta — сотрудник, вошедший под клиентом. В BILLmanager сделайте для теста отдельный метод оплаты, доступный только тестовому клиенту.

Проверьте, что счёт стал Paid и услуга продлилась, затем выключите тестовый режим. В BILLmanager, FOSSBilling и Paymenter тестовые платежи не зачисляются, когда шлюз уже в боевом режиме.

Шаг 5. Включите боевой режим и настройте вывод

• Валюта счетов. SnapEX Pay выставляет счёт в USD. Если ваши счета в рублях, евро или другой валюте, держите в биллинге актуальный курс USD: в WHMCS — Convert To For Processing = USD, в BILLmanager — метод оплаты в USD, в Blesta и WISECP — USD среди валют с курсом.
• Комиссия 1% плюс сетевой буфер монеты — удерживаются из вашей суммы или добавляются клиенту сверху, на ваш выбор.
• Монеты под недорогие тарифы. USDT в сетях TRC20, ERC20, BEP20, а также LTC, ETH и TRX — от $0,50 за счёт. Остальные монеты и USDT в Solana, TON и других сетях — в счетах от $8.
• Срок счёта SnapEX Pay — 30 минут по умолчанию, можно от 1 минуты до 24 часов; сумма — до $100 000.
• Вывод — баланс в USDT, вывод из кабинета на криптоадрес без холда. Сервисной комиссии за вывод нет, только сетевая; минимум — от $0,50 до $10 в зависимости от монеты.

Минимальная сумма счёта по монетам

• USDT TRC20 / ERC20 / BEP20, LTC, ETH, TRXот $0,50
• Остальные монеты и сетиот $8

Шкала — от 0 до $10. Счёт за VPS на пару долларов оплачивается в монетах первой строки.

Если вебхук не дошёл

Сервер биллинга перезагружали, сеть моргнула — уведомление может потеряться. Модули WHMCS и BILLmanager подтверждают оплату тремя независимыми способами, так что оплаченный счёт не останется неоплаченным.

Три способа отметить счёт оплаченным (WHMCS и BILLmanager)

1. СразуПодписанный вебхук. Модуль проверяет подпись и перечитывает счёт в API SnapEX Pay.
2. Когда клиент вернулсяВозврат со страницы оплаты. Модуль сам запрашивает статус счёта.
3. В фонеПериодическая проверка. В WHMCS — при запусках cron, каждый ожидающий платёж не чаще раза в 10 минут, в течение 5 дней; в BILLmanager — checkpay раз в 5 минут.

В Blesta и WISECP платёж записывается по вебхуку или при возврате клиента — что случится раньше.

Если клиент прислал меньше

Биржи часто вычитают комиссию за вывод из суммы перевода. Модули не зачисляют неполную оплату вслепую: в WHMCS она попадает в Gateway Log, в BILLmanager — в лог, в Blesta и WISECP — в транзакцию со статусом pending на вашу проверку. Сам счёт SnapEX Pay ждёт доплату на тот же адрес, а если её нет — закрывается как частично оплаченный, и пришедшая сумма зачисляется на ваш баланс. Подробнее — в гайде «Клиент прислал меньше суммы счёта».

Пополнение баланса клиента

Если клиенты держат в биллинге баланс и пополняют его заранее, каждому можно выдать постоянный адрес — через API, по customer_id вашего клиента. Сети: USDT TRC20, ERC20, BEP20 и Polygon, USDC Polygon, BTC, LTC, ETH и TRX. Пополнение зачисляется в USDT за вычетом обычной комиссии, минимум — $0,50, о каждом приходит вебхук. Готовые модули работают со счетами, постоянные адреса подключаются через API.

Чек-лист перед запуском

Перед тем как показать клиентам оплату криптой

• Модуль установлен под ваш биллинг: WHMCS, BILLmanager, Blesta, WISECP, FOSSBilling, Paymenter или RootPanel.
• API-ключ с правами invoices.read и invoices.write вставлен, при сохранении ошибок нет.
• Вебхук указан в кабинете SnapEX Pay по адресу из настроек шлюза, секрет whsec_… сохранён. Для Blesta — обязательно.
• Курс USD в биллинге актуален, если счета выставляются не в долларах.
• Тестовый счёт оплачен: он стал Paid один раз, услуга продлилась.
• Тестовый режим выключен, кнопку оплаты видят все клиенты.
• Адрес для вывода USDT готов, минимум вывода для своей монеты известен.

Если у вас уже есть способ оплаты

Отказываться от него не нужно: SnapEX Pay ставится в биллинг вторым способом рядом с текущим — клиент сам выберет, чем платить. Пошаговые гайды — для WHMCS и BILLmanager; на что смотреть при выборе шлюза — в статье «Как выбрать криптошлюз для хостинга». Обзор всех модулей — на странице «Криптоплатежи для хостинга».