Криптоплатежи для BILLmanager
Приём криптовалюты в BILLmanager. Клиент выбирает SnapEX Pay (crypto) при пополнении или оплате заказа, платит на странице SnapEX Pay в USDT в сетях TRON, Ethereum, BSC и других или в других монетах с конвертацией в USDT, и платёж зачисляется в BILLmanager автоматически.
Бесплатно. Версия 1.0.0.
Что умеет модуль
- Не нужно держать кошельки и ноды: деньги приходят на баланс мерчанта SnapEX Pay.
- Три независимых способа зачислить платёж: подписанный вебхук, возврат клиента со страницы оплаты и периодическая проверка (
checkpay). Потерянный вебхук не оставит оплаченный платёж незачисленным, и платёж никогда не зачтётся дважды. - Сумма всегда перечитывается из API SnapEX Pay — одно лишь тело вебхука ничего не зачисляет.
- Частичные платежи автоматически не зачисляются: в логе появляется запись для проверки.
- Тестовый режим: тестовые счета подтверждаются сами, без реальных денег, и не зачисляются после выключения тестового режима.
Установка
- На сервере BILLmanager под root:
tar xzf snapexpay-billmanager-1.0.0.tar.gz,cd snapexpay-billmanager-1.0.0,sh install.sh. Скрипт копирует модуль в/usr/local/mgr5, добавляет страховочный croncheckpayраз в 5 минут (/etc/cron.d/snapexpay) и перезапускает BILLmanager. - В кабинете мерчанта SnapEX Pay создайте API-ключ с правами
invoices.readиinvoices.write. - BILLmanager → Provider → Payment methods → Add → SnapEX Pay (crypto) (в русском интерфейсе — аналогичные пункты). Валюта: USD. Вставьте API-ключ; при сохранении он проверяется в SnapEX Pay.
- Вебхук (рекомендуется): в кабинете укажите адрес
https://<домен биллинга>/mancgi/snapexpayresultи вставьте секретwhsec_…в поле Webhook secret. - Клиенты платят в другой валюте: BILLmanager пересчитывает сумму в валюту метода оплаты (USD) по своим курсам — следите, чтобы курс USD был актуальным.
- Сначала проверьте: отдельный метод оплаты с включённым Test mode, доступный только тестовому клиенту (Payment methods → ограничения по группе клиентов). Затем выключите тестовый режим или удалите этот метод.
Настройки
| API key | Из кабинета SnapEX Pay. |
|---|---|
| Webhook secret | whsec_… из настроек вебхука в кабинете. Без него платежи всё равно зачисляются при возврате клиента и периодической проверкой. |
| Client pays the network fee | Выкл. — клиент платит ровно сумму платежа. Вкл. — комиссия сети добавляется сверху. |
| Payment window, minutes | Сколько действует страница оплаты SnapEX (1–1440, по умолчанию 60). Повторное открытие платежа позже создаёт новую страницу. |
| Test mode | Тестовые счета без реальных денег. После выключения тестовые платежи не зачисляются. |
| API URL | Оставьте пустым. |
Вопросы
Какие редакции BILLmanager поддерживаются?
BILLmanager 6, любая редакция. Модулю нужен только python3 3.6+ со стандартной библиотекой на сервере BILLmanager.
Что будет, если вебхук не дойдёт?
Платёж всё равно зачислится при возврате клиента со страницы оплаты или периодической проверкой раз в 5 минут. Дважды платёж не зачисляется.
Клиенты платят в рублях или другой валюте — заработает?
Да. Метод оплаты в USD, BILLmanager пересчитывает сумму по своим курсам; следите, чтобы курс USD был актуальным.
Что если клиент заплатил меньше?
Если клиент не доплатит вовремя, ничего не зачисляется, а в логе появляется запись «PARTIAL payment — review in SnapEX Pay and credit manually».
Что если клиент не успел оплатить?
Платёж остаётся в статусе In payment, чтобы клиент мог попробовать снова; через сутки после истечения последнего счёта SnapEX он отменяется.
Как удалить модуль?
Выполните sh install.sh --uninstall. История платежей остаётся в var/snapexpay.sqlite. Всё, что делает модуль, пишется в /usr/local/mgr5/var/pmsnapexpay.log.
Другие интеграции
Готовы принимать крипту?
Создайте аккаунт мерчанта, получите API-ключ и подключите модуль. 1% с платежа, без абонентской платы.