Fringg
31e3ccd24c
- Bump provider counter 18 → 24+ in Features and Documentation sections - Add 7 new rows to providers table: - Antilopay (RSA signing) - Etoplatezhi - Jupiter (FPGate P2P) — partner via @k_juppiter - Donut (Donut P2P) — partner via @donut_payment - Lava Business - Apple In-App Purchase - Add 2 partner cards (Jupiter, Donut) following the Platega/PayPear pattern
345 lines
17 KiB
Markdown
345 lines
17 KiB
Markdown
<div align="center">
|
|
|
|
<img src=".github/assets/logo.png" alt="Bedolaga Bot" width="800" />
|
|
|
|
# Bedolaga Bot
|
|
|
|
**Telegram-бот для автоматизации VPN-бизнеса на базе [Remnawave](https://github.com/remnawave/backend)**
|
|
|
|
Принимает оплату, выдаёт подписки, управляет пользователями — пока вы спите.
|
|
|
|
[](https://python.org)
|
|
[](https://postgresql.org)
|
|
[](https://docs.bedolagam.ru/getting-started/docker-deployment)
|
|
[](LICENSE)
|
|
|
|
[📖 Документация](https://docs.bedolagam.ru) · [🤖 Тестировать бота](https://t.me/zero_ping_vpn_bot?start=Git) · [💬 Чат сообщества](https://t.me/+wTdMtSWq8YdmZmVi)
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
## 🧩 Что такое Bedolaga?
|
|
|
|
Bedolaga — полнофункциональная платформа для продажи VPN-подписок через Telegram. Бот интегрируется с панелью [Remnawave](https://github.com/remnawave/backend) и берёт на себя весь цикл: от регистрации пользователя до автопродления подписки.
|
|
|
|
> 🖥 **[Bedolaga Cabinet](https://github.com/BEDOLAGA-DEV/bedolaga-cabinet)** — веб-кабинет на React + TypeScript, который существенно расширяет возможности бота: личный кабинет, OAuth-авторизация (Google, Yandex, Discord, VK, Telegram OIDC), лендинги, аналитика продаж, RBAC и подарочные подписки.
|
|
|
|
<div align="center">
|
|
|
|
<img src=".github/assets/bot-preview.png" alt="Bedolaga Bot — Telegram" width="700" />
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
## ✨ Возможности
|
|
|
|
<table>
|
|
<tr>
|
|
<td width="50%" valign="top">
|
|
|
|
### 📦 Подписки и тарифы
|
|
|
|
- 🎯 Гибкие тарифные планы (от X дней до X дней)
|
|
- 📊 Трафик: безлимит, фиксированный лимит или пакеты с возможностью докупки
|
|
- 📱 Управление устройствами (1–20 на подписку) или отключение лимитов
|
|
- 🌍 Автовыбор сервера(Тарифы) или ручной выбор(Конфигуратор подписки - с возможностью докупки)
|
|
- 🆓 Пробный период(Возможен платный) с конвертацией в платный
|
|
- 🛒 Умная корзина — сохраняет выбор при недостатке баланса
|
|
- 🔄 Автопродление за 3 дня до окончания
|
|
- 🎁 Подарочные подписки и конфигурируемые лендинги для быстрой продажи в вебе без авторизации
|
|
|
|
</td>
|
|
<td width="50%" valign="top">
|
|
|
|
### 💳 Платежи
|
|
|
|
- 🏦 **24+ платёжных провайдера** одновременно
|
|
- 💰 Единый баланс: пополнение любым способом → покупка с баланса
|
|
- ⚡ Автопокупка подписки после пополнения
|
|
- 💾 Рекуррентные платежи (сохранённые карты)
|
|
- 🧾 Фискализация через НалоGo (для самозанятых)
|
|
- 🔍 Автопроверка статуса платежей
|
|
- 🛍 Гостевые покупки через лендинги
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%" valign="top">
|
|
|
|
### 📣 Маркетинг и продвижение
|
|
|
|
- 🏷 Промокоды (деньги, дни подписки, триалы)
|
|
- 👥 Реферальная программа с выводом средств
|
|
- 👥 Партнерская система
|
|
- 📨 Рассылки по сегментам пользователей
|
|
- 🌐 Кастомные лендинги с аналитикой
|
|
- 🎮 Конкурсы и ежедневные игры с призами
|
|
- 🎯 Персональные предложения и скидки
|
|
- 📈 Маркетинговые кампании с трекингом
|
|
- 🌐 Обязательная мультиподписка на каналы с возможностью автоотключения подписки - при отписки от канала
|
|
|
|
</td>
|
|
<td width="50%" valign="top">
|
|
|
|
### 🛠 Администрирование
|
|
|
|
- 🤖 Панель управления прямо в Telegram
|
|
- 👤 Управление пользователями, подписками, платежами
|
|
- 📬 Уведомления в топики: покупки, продления, пополнения
|
|
- 💾 Автобэкапы БД с восстановлением из бота
|
|
- 🚧 Режим техработ (авто-детект недоступности панели)
|
|
- 📡 Мониторинг трафика и аномалий
|
|
- 🤝 Партнёрская программа
|
|
- 🔐 RBAC: роли и гранулярные права доступа
|
|
- 📈 Детальная отчетность с возможностью визуализации Реф сети
|
|
- 🔐 Блокировка юзеров из общего черного списка
|
|
И многое др...
|
|
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
---
|
|
|
|
## 💳 Платёжные провайдеры
|
|
|
|
<div align="center">
|
|
|
|
| | Провайдер | Методы оплаты | Валюта |
|
|
|:---:|:---|:---|:---:|
|
|
| ⭐ | **Telegram Stars** | Звёзды Telegram | XTR |
|
|
| 🏦 | **YooKassa** | Карты, СБП | RUB |
|
|
| 🏦 | **YooKassa СБП** | Система быстрых платежей | RUB |
|
|
| 🪙 | **CryptoBot** | USDT, TON, BTC, ETH | Crypto |
|
|
| 🪙 | **Heleket** | USDT, мульти-сеть | Crypto |
|
|
| 💳 | **CloudPayments** | Карты, 3D-Secure | RUB |
|
|
| 💳 | **Freekassa** | NSPK СБП, карты | RUB |
|
|
| 💳 | **Kassa AI** | СБП, карты, SberPay | RUB |
|
|
| 💳 | **PayPalych (Pal24)** | Карты, СБП | RUB |
|
|
| 🤝 | **[Platega](https://t.me/ArstanPlatega)** 🔸 | Карты, СБП, крипто | RUB |
|
|
| 🤝 | **[WATA](https://t.me/wyrz_wata)** 🔸 | СБП, Карты | RUB |
|
|
| 💳 | **MulenPay** | Карты | RUB |
|
|
| 💳 | **RioPay** | Карты | RUB |
|
|
| 💳 | **SeverPay** | СБП, карты | RUB |
|
|
| 🤝 | **[PayPear](https://t.me/Paymen1_Manager)** 🔸 | Карты, СБП, SberPay, T-Pay | RUB |
|
|
| 🤝 | **[RollyPay](https://rollypay.io/?utm_source=bedolaga&utm_medium=community&utm_campaign=integration)** 🔸 | СБП, карты, крипто | RUB → USDT |
|
|
| 🤝 | **[AuraPay](https://aurapay.tech/)** 🔸 | Карты, СБП | RUB |
|
|
| 🤝 | **[Overpay](https://overpay.pro/)** 🔸 | Карты, СБП | RUB |
|
|
| 🦌 | **Antilopay** | Карты, СБП, SberPay (RSA подпись) | RUB |
|
|
| 💳 | **Etoplatezhi** | Карты, СБП | RUB |
|
|
| 🪐 | **[Jupiter](https://t.me/k_juppiter)** 🔸 | СБП через QR (FPGate P2P v2.1) | RUB |
|
|
| 🍩 | **[Donut](https://t.me/donut_payment)** 🔸 | Карты, СБП по телефону, СБП QR (P2P) | RUB |
|
|
| 🌋 | **Lava Business** | Карты, СБП (gate.lava.ru) | RUB |
|
|
| 🍎 | **Apple In-App Purchase** | Покупки через iOS App Store | USD |
|
|
| 📲 | **Tribute** | Telegram-платежи | RUB |
|
|
|
|
</div>
|
|
|
|
> 🔸 — официальный партнёр Bedolaga (особые условия по кодовому слову **`bedolaga`**)
|
|
>
|
|
> Все провайдеры работают параллельно через единый веб-сервер на порту 8080. Подробная настройка — в [документации](https://docs.bedolagam.ru/bot/payments).
|
|
|
|
<div align="center">
|
|
<table>
|
|
<tr>
|
|
<td align="center">
|
|
|
|
<img src=".github/assets/platega-logo.jpg" alt="Platega" width="60" />
|
|
|
|
**🤝 Официальный партнёр Platega**
|
|
|
|
Bedolaga — официальный партнёр платёжной системы **Platega**.<br>
|
|
Пользователи бота получают **особые условия** при подключении по кодовому слову **`bedolaga`**
|
|
|
|
📩 По вопросам: [@ArstanPlatega](https://t.me/ArstanPlatega)
|
|
|
|
</td>
|
|
<td align="center">
|
|
|
|
<img src=".github/assets/wata-logo.jpg" alt="WATA" width="60" />
|
|
|
|
**🤝 Официальный партнёр WATA**
|
|
|
|
Bedolaga — официальный партнёр платёжной системы **WATA**.<br>
|
|
Пользователи бота получают **бесплатное подключение** по кодовому слову **`bedolaga`**
|
|
|
|
📩 По вопросам: [@wyrz_wata](https://t.me/wyrz_wata)
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center">
|
|
|
|
**🤝 Официальный партнёр PayPear**
|
|
|
|
Bedolaga — официальный партнёр платёжной системы **[PayPear](https://paypear.ru)**.<br>
|
|
Банковские карты, СБП, SberPay и T-Pay — всё через единый API.<br>
|
|
Подключение по **спец. условиям** через кодовое слово **`БЕДОЛАГА`**
|
|
|
|
📩 Менеджер: [@Paymen1_Manager](https://t.me/Paymen1_Manager)
|
|
|
|
</td>
|
|
<td align="center">
|
|
|
|
**🤝 Официальный партнёр RollyPay**
|
|
|
|
Bedolaga — официальный партнёр платёжного шлюза **[RollyPay](https://rollypay.io/?utm_source=bedolaga&utm_medium=community&utm_campaign=integration)**.<br>
|
|
СБП (от 5%), банковские карты РФ, крипто, вывод в USDT.<br>
|
|
Универсальная форма оплаты, высокая проходимость, стабильная работа в каскаде.<br>
|
|
Подключение по кодовому слову **`БЕДОЛАГА`** — **спец. условия**
|
|
|
|
📩 Менеджер: [@rollypay_manager](https://t.me/rollypay_manager) | 🌐 [rollypay.io](https://rollypay.io/?utm_source=bedolaga&utm_medium=community&utm_campaign=integration)
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center">
|
|
|
|
**🤝 Официальный партнёр AuraPay**
|
|
|
|
Bedolaga — официальный партнёр платёжной системы **[AuraPay](https://aurapay.tech/)**.<br>
|
|
Банковские карты и СБП через единый API с быстрой интеграцией.<br>
|
|
Подключение по кодовому слову **`БЕДОЛАГА`** — **спец. условия**
|
|
|
|
📩 Менеджер: [@kickdownm](https://t.me/kickdownm) | 🌐 [aurapay.tech](https://aurapay.tech/)
|
|
|
|
</td>
|
|
<td align="center">
|
|
|
|
**🤝 Официальный партнёр Overpay**
|
|
|
|
Bedolaga — официальный партнёр платёжного шлюза **[Overpay](https://overpay.pro/)**.<br>
|
|
Банковские карты и СБП, mTLS-авторизация, HPP-интеграция.<br>
|
|
Подключение по кодовому слову **`БЕДОЛАГА`** — **спец. условия**
|
|
|
|
📩 Менеджер: [@A_OverPay](https://t.me/A_OverPay) | 🌐 [overpay.pro](https://overpay.pro/)
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center">
|
|
|
|
**🤝 Официальный партнёр Jupiter (FPGate P2P)**
|
|
|
|
Bedolaga — официальный партнёр платёжного шлюза **Jupiter** (FPGate P2P v2.1).<br>
|
|
Эквайринг СБП через QR-код банковского приложения, HMAC-SHA256 подпись.<br>
|
|
Высокая проходимость, callback-driven архитектура, защита от replay-атак.<br>
|
|
Подключение по кодовому слову **`БЕДОЛАГА`** — **спец. условия**
|
|
|
|
📩 Менеджер: [@k_juppiter](https://t.me/k_juppiter)
|
|
|
|
</td>
|
|
<td align="center">
|
|
|
|
**🤝 Официальный партнёр Donut**
|
|
|
|
Bedolaga — официальный партнёр платёжной системы **Donut** (Donut P2P).<br>
|
|
P2P-оплата картой, СБП по номеру телефона и СБП QR — три метода через единый API.<br>
|
|
HMAC-SHA256 подпись, sticky terminal-status guard, защита от amount tampering.<br>
|
|
Подключение по кодовому слову **`БЕДОЛАГА`** — **спец. условия**
|
|
|
|
📩 Менеджер: [@donut_payment](https://t.me/donut_payment)
|
|
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
|
|
---
|
|
|
|
## 🚀 Быстрый старт
|
|
|
|
```bash
|
|
git clone https://github.com/BEDOLAGA-DEV/remnawave-bedolaga-telegram-bot.git
|
|
cd remnawave-bedolaga-telegram-bot
|
|
cp .env.example .env # заполните переменные
|
|
docker compose up -d
|
|
```
|
|
|
|
📖 Подробнее: **[Развёртывание →](https://docs.bedolagam.ru/getting-started/docker-deployment)** · **[Переменные окружения →](https://docs.bedolagam.ru/getting-started/environment)**
|
|
|
|
---
|
|
|
|
## 🏗 Стек
|
|
|
|
| | Компонент | Технология |
|
|
|:---:|:---|:---|
|
|
| 🐍 | Язык | Python 3.13, полностью async |
|
|
| 🤖 | Telegram | aiogram 3.x |
|
|
| 🗄 | База данных | PostgreSQL + SQLAlchemy 2.x + Alembic |
|
|
| 🔴 | Кэш/очереди | Redis |
|
|
| ⚡ | Web-сервер | FastAPI (webhook, платежи, Cabinet API) |
|
|
| 📝 | Логирование | structlog |
|
|
| 🐳 | Контейнеризация | Docker + Docker Compose |
|
|
| 🧹 | Линтер | ruff |
|
|
|
|
---
|
|
|
|
## 🖥 Bedolaga Cabinet
|
|
|
|
<div align="center">
|
|
|
|
[](https://github.com/BEDOLAGA-DEV/bedolaga-cabinet)
|
|
|
|
<br>
|
|
|
|
<img src=".github/assets/cabinet-preview.png" alt="Bedolaga Cabinet" width="700" />
|
|
|
|
</div>
|
|
|
|
Веб-кабинет на **React + TypeScript**, существенно расширяющий возможности бота:
|
|
|
|
| | Возможность | Описание |
|
|
|:---:|:---|:---|
|
|
| 👤 | **Личный кабинет** | Подписки, баланс, устройства, реферальная программа |
|
|
| 🔑 | **OAuth-авторизация** | Google, Yandex, Discord, VK, Telegram OIDC |
|
|
| 🌐 | **Лендинги** | Кастомные страницы для привлечения клиентов |
|
|
| 📊 | **Админ-панель** | Аналитика продаж, RBAC, управление контентом |
|
|
| 🎁 | **Подарки** | Покупка и отправка подписок другим пользователям |
|
|
| 🔍 | **Поиск платежей** | Поиск по инвойсу, клиенту с фильтрами и статистикой |
|
|
|
|
---
|
|
|
|
## 📚 Документация
|
|
|
|
| | Раздел | Описание |
|
|
|:---:|:---|:---|
|
|
| 🚀 | [Быстрый старт](https://docs.bedolagam.ru/getting-started/quickstart) | Развёртывание за 5 минут |
|
|
| 💳 | [Настройка платежей](https://docs.bedolagam.ru/bot/payments) | 24+ провайдера, webhook, фискализация, Apple IAP |
|
|
| 📦 | [Подписки и тарифы](https://docs.bedolagam.ru/bot/subscriptions) | Конфигурация планов и трафика |
|
|
| 👥 | [Реферальная программа](https://docs.bedolagam.ru/bot/referral-program) | Партнёрка и вывод средств |
|
|
| 🖥 | [Cabinet](https://docs.bedolagam.ru/cabinet/overview) | Настройка веб-кабинета |
|
|
| 🏷 | [Промо-система](https://docs.bedolagam.ru/bot/promo-system) | Промокоды, предложения, скидки |
|
|
| 🔌 | [API Reference](https://docs.bedolagam.ru/api-reference/overview) | REST API для внешних интеграций |
|
|
|
|
<div align="center">
|
|
|
|
**📖 Полная документация: [docs.bedolagam.ru](https://docs.bedolagam.ru)**
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
## 💬 Сообщество
|
|
|
|
<div align="center">
|
|
|
|
[](https://t.me/+wTdMtSWq8YdmZmVi)
|
|
[](https://github.com/BEDOLAGA-DEV/remnawave-bedolaga-telegram-bot/issues)
|
|
|
|
</div>
|
|
|
|
- 🐛 **Баги и предложения** — [GitHub Issues](https://github.com/BEDOLAGA-DEV/remnawave-bedolaga-telegram-bot/issues)
|
|
- 💬 **Вопросы и обсуждения** — [Telegram-чат](https://t.me/+wTdMtSWq8YdmZmVi)
|
|
- 🤖 **Тестирование** — [@zero_ping_vpn_bot](https://t.me/zero_ping_vpn_bot?start=Git)
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
**[MIT License](LICENSE)** — используйте свободно для личных и коммерческих проектов.
|
|
|
|
</div>
|