A Telegram bot for selling subscriptions with integration to Remnawave (https://remna.st/). This service allows users to purchase and manage subscriptions through Telegram with multiple payment system options.
/sync- Poll users from remnawave and synchronize them with the database. Remove all users which not present in remnawave.
- YooKassa API
- CryptoPay API
- Telegram Stars
- Tribute
- Purchase VPN subscriptions with different payment methods (bank cards, cryptocurrency)
- Multiple subscription plans (1, 3, 6, 12 months)
- Automated subscription management
- Subscription Notifications: The bot automatically sends notifications to users 3 days before their subscription expires, helping them avoid service interruption
- Multi-language support (Russian and English)
- Selective Inbound Assignment: Configure specific inbounds to assign to users via UUID filtering
- All telegram message support HTML formatting https://core.telegram.org/bots/api#html-style
- Healthcheck - bot checking availability of db, panel.
| Remnawave | Bot |
|---|---|
| 1.6 | 2.3.6 |
| 2 | 3.0.0 |
Web server start on port defined in .env via HEALTH_CHECK_PORT
- /healthcheck
- /${TRIBUTE_PAYMENT_URL} - webhook for tribute
The application requires the following environment variables to be set:
| Variable | Description |
|---|---|
PRICE_1 |
Price for 1 month |
PRICE_3 |
Price for 3 month |
PRICE_6 |
Price for 6 month |
PRICE_12 |
Price for 12 month |
DAYS_IN_MONTH |
Days in month |
REMNAWAVE_TAG |
Tag in remnawave |
HEALTH_CHECK_PORT |
Server port |
IS_WEB_APP_LINK |
If true, then sublink will be showed as webapp.. |
X_API_KEY |
https://remna.st/docs/security/tinyauth-for-nginx#issuing-api-keys |
MINI_APP_URL |
tg WEB APP URL. if empty not be used. |
PRICE_12 |
Price for 12 month |
STARS_PRICE_1 |
Price in Stars for 1 month |
STARS_PRICE_3 |
Price in Stars for 3 month |
STARS_PRICE_6 |
Price in Stars for 6 month |
STARS_PRICE_12 |
Price in Stars for 12 month |
REFERRAL_DAYS |
Refferal days. if 0, then disabled. |
TELEGRAM_TOKEN |
Telegram Bot API token for bot functionality |
DATABASE_URL |
PostgreSQL connection string |
POSTGRES_USER |
PostgreSQL username |
POSTGRES_PASSWORD |
PostgreSQL password |
POSTGRES_DB |
PostgreSQL database name |
REMNAWAVE_URL |
Remnawave API URL |
REMNAWAVE_MODE |
Remnawave mode (remote/local), default is remote. If local set – you can pass http://remnawave:3000 to REMNAWAVE_URL |
REMNAWAVE_TOKEN |
Authentication token for Remnawave API |
CRYPTO_PAY_ENABLED |
Enable/disable CryptoPay payment method (true/false) |
CRYPTO_PAY_TOKEN |
CryptoPay API token |
CRYPTO_PAY_URL |
CryptoPay API URL |
YOOKASA_ENABLED |
Enable/disable YooKassa payment method (true/false) |
YOOKASA_SECRET_KEY |
YooKassa API secret key |
YOOKASA_SHOP_ID |
YooKassa shop identifier |
YOOKASA_URL |
YooKassa API URL |
YOOKASA_EMAIL |
Email address associated with YooKassa account |
TRAFFIC_LIMIT |
Maximum allowed traffic in gb (0 to set unlimited) |
TELEGRAM_STARS_ENABLED |
Enable/disable Telegram Stars payment method (true/false) |
SERVER_STATUS_URL |
URL to server status page (optional) - if not set, button will not be displayed |
SUPPORT_URL |
URL to support chat or page (optional) - if not set, button will not be displayed |
FEEDBACK_URL |
URL to feedback/reviews page (optional) - if not set, button will not be displayed |
CHANNEL_URL |
URL to Telegram channel (optional) - if not set, button will not be displayed |
TOS_URL |
URL to TOS (optional) - if not set, button will not be displayed |
ADMIN_TELEGRAM_ID |
Admin telegram id |
TRIAL_TRAFFIC_LIMIT |
Maximum allowed traffic in gb for trial subscriptions |
TRIAL_DAYS |
Number of days for trial subscriptions. if 0 = disabled. |
SQUAD_UUIDS |
Comma-separated list of squad UUIDs to assign to users (e.g., "773db654-a8b2-413a-a50b-75c3536238fd,bc979bdd-f1fa-4d94-8a51-38a0f518a2a2") |
TRIBUTE_WEBHOOK_URL |
Path for webhook handler. Example: /example (https://www.uuidgenerator.net/version4) |
TRIBUTE_API_KEY |
Api key, which can be obtained via settings in Tribute app. |
TRIBUTE_PAYMENT_URL |
You payment url for Tribute. (Subscription telegram link) |
The bot dynamically creates buttons based on available environment variables:
- Main buttons for purchasing and connecting to the VPN are always shown
- Additional buttons for Server Status, Support, Feedback, and Channel are only displayed if their corresponding URL environment variables are set
The bot includes a notification system that runs daily at 16:00 UTC to check for expiring subscriptions:
- Users receive a notification 3 days before their subscription expires
- The notification includes the exact expiration date and a convenient button to renew the subscription
- Notifications are sent in the user's preferred language
The bot supports selective inbound assignment to users:
- Configure specific inbound UUIDs in the
INBOUND_UUIDSenvironment variable (comma-separated) - If specified, only inbounds with matching UUIDs will be assigned to new users
- If no inbounds match the specified UUIDs or the variable is empty, all available inbounds will be assigned
- This feature allows fine-grained control over which connection methods are available to users
- Clone the repository
git clone https://github.com/Jolymmiels/remnawave-telegram-shop && cd remnawave-telegram-shop- Create a
.envfile in the root directory with all the environment variables listed above
mv .env.sample .env- Run the bot:
docker compose up -dWarning
To integrate with Tribute, you must have a public domain (e.g., bot.example.com) that points to your bot server.
Webhook and subscription setup will not work on a local address or IP — only via a domain with a valid SSL
certificate.
The bot supports subscription management via the Tribute service. When a user clicks the payment button, they are redirected to the Tribute bot or payment page to complete the subscription. After successful payment, Tribute sends a webhook to your server, and the bot activates the subscription for the user.
- Getting started
- Create a channel;
- In the Tribute app, open "Channels and Groups" and add your channel;
- Create a new subscription;
- Obtain the subscription link (Subscription -> Links -> Telegram Link).
-
Configure environment variables in
.env- Set the webhook path (e.g.,
/tribute/webhook):
TRIBUTE_WEBHOOK_URL=/tribute/webhook- Set the API key from your Tribute settings:
TRIBUTE_API_KEY=your_tribute_api_key- Paste the subscription link you got from Tribute:
TRIBUTE_PAYMENT_URL=https://t.me/tribute/app?startapp=...- Specify the port the app will use:
HEALTH_CHECK_PORT=82251 - Set the webhook path (e.g.,
-
Restart bot
docker compose down && docker compose up -dGo to folder translations inside bot folder and change needed language.
- Pull the latest Docker image:
docker compose pull- Restart the containers:
docker compose down && docker compose up -dIf you are not using ngrok from docker-compose.yml, you need to set up a reverse proxy to forward requests to the bot.
Traefik Configuration
http:
routers:
remnawave-telegram-shop:
rule: "Host(`bot.example.com`)"
entrypoints:
- http
middlewares:
- redirect-to-https
service: remnawave-telegram-shop
remnawave-telegram-shop-secure:
rule: "Host(`bot.example.com`)"
entrypoints:
- https
tls:
certResolver: letsencrypt
service: remnawave-telegram-shop
middlewares:
redirect-to-https:
redirectScheme:
scheme: https
services:
remnawave-telegram-shop:
loadBalancer:
servers:
- url: "http://bot:82251"If you appreciate this project and want to help keep it running (and fuel those caffeine-fueled coding marathons), consider donating. Your support helps drive future updates and improvements.
Donation Methods:
-
Bep20 USDT:
0x4D1ee2445fdC88fA49B9d02FB8ee3633f45Bef48 -
SOL Solana:
HNQhe6SCoU5UDZicFKMbYjQNv9Muh39WaEWbZayQ9Nn8 -
TRC20 USDT:
TBJrguLia8tvydsQ2CotUDTYtCiLDA4nPW -
TON USDT:
UQAdAhVxOr9LS07DDQh0vNzX2575Eu0eOByjImY1yheatXgr