К содержанию

Приём криптовалюты в WHMCS

Шлюз CoinsPay позволяет клиентам оплачивать счета WHMCS в USDT, BTC, ETH или другой из 30+ монет. Платёж сам добавляется в счёт, WHMCS выдаёт или продлевает услугу, а деньги уходят прямо на ваши кошельки.

WHMCS
7.0 и новее
PHP
от 5.6 до 8.5
Модуль
бесплатный, GPL 2.0

Что даёт шлюз

  • Услуги включаются сами

    Когда платёж подтверждён, шлюз добавляет его в счёт, а WHMCS делает то же, что после любой оплаты: отмечает счёт оплаченным, выдаёт или продлевает услугу и пишет клиенту. Проверять платежи вручную не нужно.

  • Деньги сразу на ваших кошельках

    CoinsPay не держит выручку у себя: каждая оплата уходит на ваши кошельки по правилу выплат магазина. В каждой сети до 5 адресов с долями, например 70 % вам и 30 % партнёру.

  • Цены остаются в вашей валюте

    Клиент платит остаток по счёту в его валюте. CoinsPay пересчитает сумму в монету по текущему курсу и удержит её 30 минут, пока клиент открывает кошелёк. Если CoinsPay не принимает вашу валюту, укажите в «Convert To For Processing», например, USD.

  • Ключ, которым нельзя вывести деньги

    Шлюзу хватает ключа с доступом «Только счета»: им можно выставлять счета и следить за ними, а вывести деньги нельзя.

Подключение за пять минут

Нужны кабинет CoinsPay с магазином и доступ к админке WHMCS. Программист не нужен.

  1. 01Установите модульСкачайте архив и скопируйте содержимое его папки upload в корень WHMCS, где лежит configuration.php. Затем найдите CoinsPay среди платёжных шлюзов и включите его.
  2. 02Вставьте ключВ кабинете CoinsPay выпустите ключ с доступом «Только счета» и вставьте его в поле «API key». Поле «API address» оставьте пустым.
  3. 03Подключите вебхукВ разделе «Вебхук» кабинета укажите адрес вашего WHMCS с окончанием /modules/gateways/callback/coinspay.php, а ключ подписи whsec_ скопируйте в поле «Webhook secret».
  4. 04Проверьте тестовой оплатойСсылка «Check the connection» покажет ваш магазин и какие из ваших валют принимает CoinsPay. Затем оплатите один счёт с ключом cpk_test_: деньги не двигаются, а в вашем WHMCS счёт станет оплаченным.

Шлюз справляется и с неудобными случаями

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

  • Каждый платёж один раз

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

  • Счёт изменился

    Измените сумму счёта, отмените его, оплатите другим способом или переключите на другой шлюз, и модуль отменит открытый счёт CoinsPay. Следующее нажатие кнопки оплаты создаст счёт на новую сумму.

  • Платежи на ваше решение

    Платёж за счёт, который успели отменить или оплатить иначе, сам не добавляется. О нём появится запись «CoinsPay» в журнале действий и предупреждение на странице счёта в админке: добавьте его вручную или верните деньги из кабинета.

  • Недоплата

    Если пришло меньше, клиент может доплатить на той же странице оплаты. Если счёт CoinsPay истечёт раньше, полученная часть ждёт вашего решения, а на странице счёта в админке появится предупреждение.

  • Переплата

    В счёт добавляется его остаток, и счёт оплачен. Излишек в WHMCS не добавляется, а на счёте появляется предупреждение: верните его из кабинета или оставьте.

  • Ни один платёж не потеряется

    Вебхуки приходят с подписью, и шлюз её проверяет. Даже без вебхуков модуль спрашивает CoinsPay об открытых счетах при каждом запуске крона WHMCS и когда клиент открывает счёт.

  • Комиссию может платить клиент

    Включите эти настройки, и комиссия CoinsPay и комиссия сети прибавятся к сумме на странице оплаты. В счёт WHMCS зачислится его собственный остаток.

  • Свой текст кнопки

    Кнопка в счёте может называться «Оплатить криптовалютой» или как вам удобно. Если поле пустое, это обычная кнопка «Pay Now» самого WHMCS на языке клиента.

  • Тестовый режим

    С тестовым ключом cpk_test_ счёт оплачивается кнопкой на странице оплаты, монеты не двигаются. Шлюз видят только вошедшие администраторы, настоящие клиенты его не заметят.

Установка

Модуль — один архив на GitHub рядом с исходным кодом. Скопируйте его файлы в корень WHMCS: добавятся шлюз и небольшой файл хуков.

Документация API
WHMCS
7.0 и новее
PHP
от 5.6 до 8.5, как нужно вашему WHMCS
Cron
крон WHMCS, который нужен ему самому
Лицензия
GPL 2.0 или новее

Платите, только когда получаете деньги

  • Первые 10 дней без комиссии, на выплаты до $500
  • Без абонентской платы и платы за подключение
  • Комиссию можно включить в счёт покупателя
  • Комиссия сети по факту, без наценки

от0,3 %с выплаты, ставка зависит от оборота

Подключить магазинКак считается комиссия

Вопросы о шлюзе

Все вопросы
Сколько стоит модуль?

Модуль бесплатный. Вы платите только комиссию CoinsPay с выплат: от 0,3 %, ставка снижается с ростом оборота, абонентской платы нет. Первые 10 дней после первого платежа выплаты до $500 идут без комиссии.

Какие монеты сможет выбрать клиент?

Больше 30 монет и токенов в сетях TRON, Ethereum, BNB Smart Chain, Solana, Bitcoin и Litecoin: USDT, USDC, BTC, ETH, BNB, TRX, LTC, SOL и другие. В настройках шлюза можно оставить только стейблкоины.

Услуга включится сразу после оплаты?

Да. Как только шлюз добавил платёж, счёт оплачен, и WHMCS выдаёт или продлевает услугу, как после любой оплаты, например хостинг или VPS, и пишет клиенту.

Как проверить модуль до настоящих платежей?

Оплатите один счёт в тестовом режиме. Выставьте своему клиентскому аккаунту счёт с произвольной строкой, включите «Add test payments», оплатите его с ключом cpk_test_ и убедитесь, что счёт стал оплаченным. Деньги не двигаются, а по шагам это описано в README модуля.

Нужен ли cron?

Крон WHMCS нужен ему самому, а модуль при каждом запуске проверяет открытые счета, даже если вебхук не дошёл. Без крона такой платёж придёт, когда клиент откроет счёт.

Шлюз работает на русском?

Да. Сообщения для клиента идут на его языке в WHMCS, русском или английском, и страница оплаты открывается на нём же. Настройки шлюза в админке — на английском.

Какие данные клиента уходят в CoinsPay?

Номер счёта, сумма и валюта и адрес, куда вернуть клиента после оплаты. Имена, почта, адреса и телефоны клиентов в CoinsPay не передаются.

Можно подключить тестовую копию WHMCS?

Да, но заведите для неё отдельный магазин в CoinsPay. У магазина один адрес вебхука, и события пришли бы только на один из двух сайтов.

Начните принимать криптовалюту сегодня

Регистрация займёт минуту, настройка магазина ещё пять. За подключение платить не нужно.

WHMCS и логотип WHMCS — товарные знаки WHMCS Limited. CoinsPay не связан с WHMCS Limited, а модуль не спонсирован и не одобрен ею.