Подключение CryptoBot
Как создать приложение Crypto Pay в @CryptoBot, получить токен, включить вебхуки и принимать оплату криптовалютой в Reefox Panel.
CryptoBot (@CryptoBot) — криптокошелёк внутри Telegram. Его платёжный сервис Crypto Pay выставляет счета, которые клиент оплачивает криптовалютой прямо в Telegram. Reefox Panel выставляет счёт в рублях, клиент сам выбирает монету, а деньги приходят на баланс вашего приложения в CryptoBot.
Что где лежит в админке, описано в справочнике Настройки → Платежи. Здесь — что сделать в самом CryptoBot.
Что понадобится
- Telegram-аккаунт, с которого вы будете управлять кошельком. Лучше тот же, что владеет ботом сервиса, и с включённой двухэтапной проверкой.
- Работающий домен Reefox Panel с HTTPS.
- Доступ к админке Reefox Panel.
Договора, анкеты и модерации у Crypto Pay нет: приложение создаётся в боте за пару минут.
Сначала — разговор с юристом и бухгалтером
Правила приёма криптовалюты за услуги в России меняются. Перед запуском уточните у юриста, можно ли вам принимать оплату в криптовалюте, и у бухгалтера — как учитывать такой доход и чеки. Reefox Panel чеки в «Мой налог» по оплатам CryptoBot по умолчанию не создаёт: тумблер CryptoBot в разделе Мой Налог выключен.
Шаг 1. Кошелёк CryptoBot
Откройте в Telegram официального бота @CryptoBot. Проверьте имя: у мошеннических копий похожие названия.
Нажмите «Start» и следуйте подсказкам бота: язык, условия использования.
Шаг 2. Как описать услугу
Название приложения клиент увидит в счёте. Назовите его так же, как ваш сервис, например Example Service. Описание платежа Reefox Panel подставляет сам. Слово «VPN» в названии можно не выносить: клиент и так понимает, за что платит, по вашему боту.
Шаг 3. Приложение и токен
В @CryptoBot откройте Crypto Pay — кнопкой в меню или командой /pay.
Нажмите «Create App» и введите название приложения.
Бот покажет API-токен приложения. Скопируйте его.
В админке Reefox Panel откройте Настройки → Платежи → Подключения и раскройте CryptoBot. Вставьте токен в поле API token.
Включите переключатель «Включить CryptoBot» и нажмите «Сохранить платежи». Статус должен стать «Включён».
Токен — как пароль от кассы
С токеном можно выставлять счета и управлять балансом приложения. Не пересылайте его в чатах. Если токен утёк, выпустите новый в настройках приложения и сразу вставьте его в Reefox Panel.
Шаг 4. Вебхуки
Вебхук — сообщение от CryptoBot о том, что счёт оплачен. Без него Reefox Panel не узнает об оплате: фоновой проверки счетов CryptoBot в панели нет.
В админке, в блоке CryptoBot, нажмите «Копировать» у поля «Адрес уведомлений». Адрес выглядит так: https://ваш-домен/api/webhooks/cryptobot.
В @CryptoBot откройте Crypto Pay → My Apps и выберите своё приложение.
Откройте Webhooks и нажмите «Enable Webhooks».
Отправьте боту скопированный адрес.
- Reefox Panel обрабатывает событие
invoice_paid— «счёт оплачен». Других событий у Crypto Pay сейчас нет. - Каждый вебхук подписан токеном приложения. Reefox Panel проверяет подпись. Если токен в админке не совпадает с токеном приложения, вебхук отклоняется.
- Адрес уведомлений всегда с основным доменом панели, а не с адресом зеркала или CDN. Если поля «Адрес уведомлений» в админке нет, у сервера не задан домен — закончите установку с доменом.
- Если ваш сервер долго не отвечает на вебхуки, CryptoBot может их отключить. После простоя сервера загляните в Webhooks и проверьте, что они включены.
Шаг 5. Проверочная оплата
Купите самый дешёвый пакет со своего Telegram-аккаунта, способ — CryptoBot.
Откроется счёт в @CryptoBot. Выберите монету и оплатите.
Проверьте, что доступ продлился, а в разделе Платежи оплата стала «Оплачен».
Тестовая сеть в Reefox Panel не включается
У CryptoBot есть тестовый бот @CryptoTestnetBot с ненастоящими монетами. В админке Reefox Panel переключателя тестовой сети нет, поэтому токен из @CryptoTestnetBot работать не будет. Проверяйте настоящим платежом от 10 ₽.
Как живёт счёт
- Сумма счёта — в рублях. Монету клиент выбирает сам, например USDT, TON, BTC, ETH, LTC, BNB, TRX или USDC. Курс пересчёта считает CryptoBot.
- Минимальная сумма — 10 ₽. Пакет дешевле оплатить через CryptoBot не получится.
- В Reefox Panel счёт закрывается через 15 минут, но в самом CryptoBot остаётся открытым. Если клиент оплатит его позже, оплата всё равно засчитается.
- Деньги приходят на баланс приложения в той монете, которой заплатил клиент. Вывести их можно через @CryptoBot.
- Платёж в криптовалюте нельзя отменить. Кнопки возврата в Reefox Panel нет: вернуть деньги можно только переводом из своего кошелька.
Частые ошибки
| Что видно | Причина | Что сделать |
|---|---|---|
| Клиент заплатил, доступ не выдан | Вебхуки не включены или указан не тот адрес | Включите вебхуки на адрес из админки. Уже оплаченный доступ выдайте клиенту вручную |
| Вебхуки включены, но оплаты не засчитываются | В админке токен другого приложения или старый токен | Вставьте токен этого приложения и сохраните |
| Способ CryptoBot не работает у клиента | Провайдер выключен, нет токена или пакет дешевле 10 ₽ | Проверьте статус в «Подключения» и цену пакета |
| Счёт не создаётся | Вставлен токен из @CryptoTestnetBot или токен с ошибкой | Создайте приложение в основном @CryptoBot |
| Вебхуки сами выключились | Сервер долго не отвечал | Включите их снова в Webhooks |