Telegram bot for selling digital currency
Technical Specification
Telegram Bot for Selling Digital Goods via Payment Gateway and Supplier API
Technologies
Python 3.11+
Aiogram 3.x
FastAPI
SQLite
Aiosqlite
Webhook for Payments
.env for Configuration
1. DATABASE
Table users:
user_id (Telegram ID)
username
balance_uah
referer_id
registration_date
Table orders:
order_id
user_id
game_username
game_user_id
quantity
price
status
created_at
Order statuses:
Pending
Queued
Queued_Deferred
Completed
Error
Cancelled
Table payments:
payment_id
user_id
amount
status
created_at
Statuses:
pending
success
Table settings:
product_rate
referral_reward
2. USER PART
Main Menu
Buttons:
👤 Profile
💰 Top Up Balance
📦 Buy Product
📈 Current Rate
🛟 Support
Profile
The user is shown:
Telegram ID
Username (entered at the beginning)
Balance UAH
Number of invited users
Referral link
Example:
ID: 123456789
Username: XXXX_XX
Balance: 500 UAH
Invited friends: 12
Your referral link: link
3. REFERRAL SYSTEM
When following the referral link:
the bot saves referer_id.
After a successful balance top-up by the invited user:
the referrer automatically receives a bonus;
the bonus amount is set in settings.
4. BALANCE TOP-UP (RELATED TO WEBHOOK)
The user clicks:
💰 Top Up Balance
The bot asks for the amount.
The user enters the amount.
Next:
A record is created in payments.
A unique payment_id is generated.
An invoice is created via WayForPay, Monobank, etc.
The user receives a button:
Pay
After successful payment:
The payment gateway sends a webhook.
The bot verifies the digital signature.
Finds payment_id.
Checks that the payment has not been processed yet.
Changes status to success.
Credits money to balance_uah.
Credits referral bonus (if applicable).
Sends a message to the user:
"Balance successfully topped up by XX UAH."
5. BUYING PRODUCT
The user clicks:
📦 Buy Product
STEP 1
The bot asks for the quantity.
The user enters the quantity.
STEP 2
The bot calculates the cost:
cost = quantity × current rate
Shows:
quantity
rate
total price
Button:
Continue
STEP 3
Balance check.
If balance_uah is insufficient:
The bot offers to top up the balance.
If sufficient:
Deducts funds.
STEP 4
The bot takes Username.
STEP 5
The bot automatically fills in the entered Username in the supplier's order form.
The user only enters:
nickname
GamePass ID
quantity taken from step 2
STEP 6
The bot shows the user summary information:
Nickname:
GamePass ID:
Quantity:
Cost:
Button: Confirm Order
STEP 7
After confirmation:
A record is created in orders.
Data is sent to the supplier via API.
Supplier's order_id is saved.
STEP 8
The supplier changes the order status via webhook.
Possible statuses:
Pending
Queued
Queued_Deferred
Completed
Error
Cancelled
With each status change:
the record is updated in the database;
a message is sent to the user.
With status Completed:
"Your order has been successfully completed."
With status Error or Cancelled, the user is advised to contact support
6. CURRENT RATE
Button:
📈 Current Rate
Shows the current price of one unit of the product.
Example:
1 unit = 1 UAH
Button:
Buy
7. SUPPORT
Button:
🛟 Support
Displays:
Support Telegram
8. ADMIN PANEL
Command:
/admin
Access only for ADMIN_ID.
Statistics
Show:
number of users
number of orders
number of successful payments
total amount of top-ups
Mailing
The admin enters the text.
The bot sends a message to all users.
There should be protection against FloodWait.
Change Rate
The admin enters a new rate.
The value is saved in settings.
The new rate is immediately used in all calculations.
Issue Balance
The admin enters:
Telegram ID
amount
The bot credits funds to balance_uah.
A log of the operation is recorded.
9. SECURITY
Verification of payment webhook signature.
Protection against double payment crediting.
Protection against reprocessing of the same order.
Verification of ADMIN_ID before opening the admin panel.
All secrets should be stored in .env.
Additional Requirements
- The code should be structured in folders
- Use of .env for configuration
- Asynchronous code
- Comments in the code
- Instructions for launching
- Ability to run on VPS Linux
From the executor, I request
- Estimated cost.
- Estimated timelines.
- Which payment systems have been integrated before.
-
Andriy, I can implement such a bot turnkey: asynchronous Python 3.11+ with Aiogram 3, FastAPI, SQLite/Aiosqlite, payment and supplier webhooks, .env, and folder structure. I will create a referral system, balance top-up, purchase with status checks, admin panel, and protection against duplicates. I have already integrated WayForPay, Mono, LiqPay, PayPal. I will be able to provide approximate timelines and costs after a brief clarification of the logic.
-
Good day! I will build it turnkey — we have a ready-made foundation for such bot-stores (profile, balance, orders, admin panel), it just needs to be adjusted to your specifications and the supplier's API.
I will use your stack: Python 3.11, Aiogram 3, FastAPI for webhooks, SQLite/aiosqlite, secrets in .env, asynchronously, with comments and instructions for launching on VPS.
Payments: I have implemented payment acceptance via webhooks with signature verification and protection against double charging. For Ukrainian payments — Monobank Acquiring and WayForPay; I will connect the one that is more convenient for you.
Approximately 7500 UAH, 5 working days, through Safe. This cost includes a referral system, order statuses with push notifications, and the entire admin panel — statistics, mailing with FloodWait protection, exchange rate changes, manual balance accrual.
One clarification regarding steps 7-8: who is the supplier of the goods and what is their API for creating orders and webhook statuses? This will determine how to set up the integration.
…
I am ready to show a live demo of a similar bot so you can see the logic before we start.
-
Hello, I worked on a Telegram bot for selling in-game currency with WayForPay integration and automatic order processing through the supplier's API, handling over 15,000 transactions totaling 2.5 million UAH.
Are you planning to use a specific digital currency supplier's API, or do you need integration with multiple providers at the same time?
I suggest we get in touch; I will provide you with free technical consultation and we can create a development plan + I will tell you about my team! ✨
-
2163 14 0 1 Good day. I am an individual developer with over 4 years of experience in Python Full-stack development, setting up asynchronous architectures on Aiogram/FastAPI, and Linux system administration. I work officially through a sole proprietorship, ensuring direct transparent communication without managers and guaranteeing clean code without "crutches" with detailed comments. I will independently design the SQLite data schema, configure Aiogram routers for each menu button (Profile, Buy, Course), set up FastAPI for stable status reception from the supplier, and write a step-by-step guide for launching the bot via systemd/Docker on your VPS.
Experience with payment systems: I have personally integrated payment widgets and webhooks for Monobank, WayForPay, LiqPay, and Cryptomus.
Timeline and budget: The work will take 4–5 days of pure time, the budget is fixed — $320–400, and my engineering approach is presented here: 3magency.co, https://vilors.studio/. Please send the API documentation from the supplier in a private message, I am available.
-
285 Hello. Our small team has been designing business solutions, system analytics, and developing asynchronous services in Python for over 4 years. The bot for selling game currency/GamePass fully aligns with our profile: we clearly implement a step-by-step purchase of the product, a referral system with cookie link storage in the database, and an admin panel with protection against Telegram blocks (asynchronous mailing queue with timeouts).
Experience with payment systems: We have worked with the APIs of Monobank, WayForPay, LiqPay, and AnyPay.
Timeline and budget: The project will be ready in 4–6 working days, with a cost starting from $380 for the entire pool of tasks.
-
315 Hello, I have read the technical assignment. The project is quite extensive: a Telegram bot, a database, FastAPI, a payment webhook, a referral system, a supplier API, an admin panel, and deployment on a VPS.
I can consider implementing it in stages: first the basic logic of the bot, users, balance, orders, and the admin panel, then connecting the payment system and the supplier API.
For an accurate estimate, the following needs to be clarified:
- Which payment system will be used: WayForPay, Monobank, or another;
- Is there documentation for the supplier API;
- Is deployment through a webhook required or is polling acceptable in the first stage;
- Is there a ready VPS/domain/SSL.
…
Preliminarily, I estimate the timeline for such a project to be 2-4 weeks, and the cost depends on the chosen payment system and the complexity of the supplier API.
-
184 Good day. My colleague and I have been specializing in backend architecture development in Python, creating asynchronous Telegram ecosystems, and automating B2C sales for over 4 years. The task of implementing a digital goods bot is very clear to us, and we will execute it through a secure staging environment. We will pay special attention to security: we will set up MIDDLEWARE to check ADMIN_ID, implement HMAC-SHA256 validation of digital signatures from WayForPay/Monobank webhooks, and ensure complete logging of admin operations during manual fund allocation.
-
1175 13 0 3 Hello. My partner (UI/UX designer + full-stack developer) and I have over 4 years of experience in creating automated solutions, complex bots on Aiogram 3.x, and integrating external supplier APIs. Your technical task is perfectly designed in terms of database architecture, and we are ready to implement this project turn-key. We will deploy a FastAPI server for parallel reception of webhooks from payment gateways and the supplier, set up asynchronous transactions in SQLite via aiosqlite with strict protection against Race Conditions (double balance deductions), and package the bot in a clean folder structure (handlers, middlewares, services, database) with configuration through pydantic-settings. Experience with payment systems: Previously, we successfully integrated WayForPay, Monobank API (Monopay), LiqPay, as well as crypto merchants (Cryptomus/WhitePay).
Timeline and budget: Creating the bot, testing webhooks, admin panel with FloodWait protection, and deployment on your Linux VPS will take 5–7 days, fixed budget — $350–450. Our engineering approach to building reliable asynchronous systems is reflected in our portfolio: hyperfi.tech, espressolab.com.ua, hudi.com.ua.
-
937 5 0 1 Hello! I am Volodymyr, the founder of the engineering agency Vaysed. Your detailed technical task for developing a Telegram bot for selling digital goods perfectly matches our team's profile. We specialize in creating asynchronous bots in Python using the Aiogram 3.x framework. The architecture you proposed with FastAPI for handling webhooks and SQLite via aiosqlite for the database is a reliable solution. We will ensure a clear modular code structure, move all sensitive data to a configuration file, and set up secure verification of digital signatures from payment systems to prevent double charging or transaction forgery.
Regarding your question about payment systems: we have extensive practical experience in integrating acquiring services. For example, for our project Nova Party, we successfully implemented seamless integration with Monobank, and within other commercial products, we configured work with Stripe and various crypto processing services. We have deeply refined the mechanics of reliable interaction with external APIs of suppliers, constant monitoring of order statuses, and secure database operations in the architecture of our autonomous system Lumos and the RESTART 2026 platform.
The functionality of the admin panel will be implemented with strict consideration of Telegram limits and protection against FloodWait during mass mailings. After completing the coding, we will prepare detailed documentation with comments and assist with deploying the project on your Linux VPS server.
The exact cost of developing such a turnkey project will depend on the specifics of your product supplier's API and the final number of payment systems to be connected. The estimated execution time is from 10 to 14 working days. You can verify our engineering approach on the official agency website https://vaysed.me/. Message me privately to provide the API documentation of the supplier, and we will promptly start working on your bot.
-
9927 117 0 Hello.
I develop bots for Telegram using NodeJS. I have experience with various payment systems: WayForPay, Liqpay, Mono, Stripe. Write to me, and we will discuss.
-
556 1 0 Good day!
I have reviewed the specifications. The project is entirely feasible on the stack of Python + Aiogram 3 + FastAPI and looks like a full-fledged service with balances, payments, a referral system, and integration with an external supplier API.
I have experience in developing Telegram bots, integrating payment systems, webhooks, REST APIs, and building asynchronous services in Python.
For transparency in the work, I propose to break the project into 4 stages with separate verification of each functional block:
**Stage 1 — Basic architecture and user functionality ($250)**
…
* project structure setup;
* FastAPI + Aiogram 3;
* database and models;
* user registration;
* user profile;
* referral system;
* configuration via .env.
**Stage 2 — Balance top-up and payments ($250)**
* payment system integration;
* invoice creation;
* webhook payment processing;
* protection against double crediting;
* automatic balance top-up;
* referral bonuses accrual.
**Stage 3 — Order system and integration with supplier API ($300)**
* purchase processing;
* balance verification and deduction;
* order creation;
* sending data to the supplier via API;
* order status processing;
* notifying users about status changes.
**Stage 4 — Admin panel, testing, and launch ($200)**
* statistics;
* mailings;
* exchange rate changes;
* balance issuance;
* operation logging;
* final testing;
* launch instructions;
* deployment on VPS Linux.
Estimated completion time: 2–3 weeks.
Total MVP budget: $1000.
For a more accurate estimate, I would like to clarify:
* which payment system is planned to be used (WayForPay, Monobank, or another);
* whether there is API documentation from the supplier;
* whether setup and deployment on the server are required as part of the project.
I am ready to discuss the details and propose an optimal architecture before starting the work.
-
690 5 1 Hello, write to me in private messages to discuss the details, I will complete it quickly as this is my stack.
-
7753 56 0 3 Hello! I am an experienced developer, capable of creating bots of any complexity, ranked TOP-4 in the "Bot Development" category. I also develop websites and API documentation in Python, where I hold TOP-2 as well.
Regarding your project, I have some clarifying questions that will affect the assessment of your task and help understand what you want. Please write to me to clarify all the details!
You can check my skills in my resume 👉Freelancehunt
My works are also published in my portfolio 👉Freelancehunt
💻 I am also the CEO of a team consisting of a FrontEnd developer and a BackEnd developer! So if necessary, our team of three can organize a turnkey development for you!
… I look forward to your response, thank you.
-
993 6 1 Good day.
I have reviewed the technical task. Overall, the task is clear: a Telegram bot on Python/Aiogram with user balance, a referral system, payments via webhook, purchasing digital goods through the supplier's API, an admin panel, and data storage in SQLite.
I can fully implement such a project turn-key.
Estimated cost: from $700 to $1200, depending on the chosen payment system, the complexity of the supplier's API, and details regarding the admin panel.
Estimated timeline: 10–18 working days.
…
What is included in the work:
— project structure by folders;
— asynchronous code in Python 3.11+;
— Aiogram 3.x;
— FastAPI for webhook;
— SQLite + aiosqlite;
— .env for all tokens and secrets;
— payment gateway integration;
— webhook signature verification;
— protection against duplicate payment processing;
— balance logic and referral bonuses;
— order processing through the supplier's API;
— order status handling via webhook;
— admin panel;
— messaging with FloodWait handling;
— instructions for launching on VPS Linux.
I have previously worked with payment systems integrating via webhook/API, specifically with Monobank, WayForPay, and similar payment services. The specific system can be agreed upon before starting — it is preferable to determine right away how payments will be accepted.
Before starting, we need to clarify:
1. Which payment gateway are we using: WayForPay, Monobank, or another?
2. Is there already API documentation from the supplier?
3. Do we need to create separate logs for admin operations?
4. Should there be an order and top-up history in the user profile?
5. Where is the hosting planned: VPS, Docker, systemd?
After clarifying these details, I will be able to provide an exact price and final timeline.
-
3083 31 0 Hello! The technical specification is excellent and detailed; I am fully ready to implement the project in Python 3.11+, using the asynchronous stack Aiogram 3.x and FastAPI for handling webhooks.
I have extensive experience integrating payment systems (Monobank, WayForPay, LiqPay) with full signature verification (X-Signatures) to protect against duplicate charges, as well as setting up robust API integrations with service providers.
The project will be structured into architectural folders (handlers, database, services, middlewares), configuration via .env, logging processes, and a complete guide for deployment on Linux VPS (Docker if desired).
Estimated cost: $300 (full implementation according to the technical specification).
Timeline: 3 days.
-
321 Вітаю. Можу розробити Telegram-бота на Python з Aiogram 3.x, SQLite/aiosqlite, FastAPI для webhook та конфігурацією через .env.
За ТЗ бачу такі ключові модулі: реєстрація користувачів, профіль і баланс, поповнення через платіжний шлюз, перевірка webhook-підпису, захист від повторної обробки платежу, купівля товару через API постачальника, статуси замовлень, реферальна система, адмін-панель, зміна курсу, видача балансу, статистика й розсилка із захистом від FloodWait.
З Telegram-ботами, SQLite, асинхронною логікою, inline-кнопками, .env і структурованим Python-кодом працював. Платіжний шлюз можу інтегрувати за документацією WayForPay або Monobank, але перед стартом потрібно уточнити, який саме шлюз буде використовуватись і чи є тестові ключі.
Перед точною оцінкою потрібно побачити документацію API постачальника: створення замовлення, статуси, webhook, авторизація, приклад запиту/відповіді.
Орієнтовно: 8 000 грн, 10 днів для базової версії з одним платіжним шлюзом і одним API постачальника. Якщо API постачальника складний або треба кілька платіжних систем — оцінку краще уточнити після перегляду документації
-
1362 3 0 Hello. The technical specification for a digital currency sales bot with a FastAPI backend under webhook, referral system, and Aiosqlite is clear; I understand the entire architecture. I have worked with WayForPay and Monobank API, and I created a similar bot for topping up in-game currency: 400+ transactions per day, verified the signature at the FastAPI endpoint level to avoid overloading the aiogram worker. Questions regarding the scope: which specific digital goods provider are we using, and do they have a ready API or do we need to figure out their response format?
-
4611 52 1 Good day, I am a Python developer with extensive experience in developing Telegram bots of various complexity. I can complete your order quickly and efficiently. Write to discuss the details, I am ready to start today. I will also upload your bot to the server for stable operation 24/7 and I will provide technical support for the bot for another month. This is included in the cost.
-
196 We already have a practically ready similar solution that can be quickly adapted to your scenario and launched. We can discuss it here on the marketplace; I am available. ))
The benchmark is 65,000 UAH, and the timeline is 16 working days after the payment gateway, supplier API, and test keys are agreed upon.
We have previously worked with payment systems like WayForPay, LiqPay, Monobank, Fondy, and Stripe, using webhooks, signature verification, protection against duplicate charges, and payment status logic.
For implementation, I would divide the system into a bot, FastAPI for webhooks, a payment processing layer, a supplier API layer, an SQLite database with migrations, an admin menu, and a log of critical operations. We can keep it simple, but the areas dealing with money and order statuses need to be handled carefully—no payment or webhook should be processed twice.
AI can be added as a separate layer—for example, semi-automated support responses, admin hints on problematic orders, or detection of suspicious payments.
…
Questions for accurate estimation:
- Which gateway do we choose first—WayForPay, Monobank, or another?
- Is there documentation for the supplier API and examples of webhooks with statuses Pending, Queued, Completed, Error, Cancelled?
From you, we need the bot token, ADMIN_ID, test keys for the payment system, supplier API documentation, and access to VPS or parameters for preparing the launch instructions.
Relevant examples:
- https://business.ingello.com/prime-eva - e-commerce logic, integrations, and sales operations
- https://business.ingello.com/vorfahr - process automation, API, and digital product
- https://systems-fl.ingello.com/ua - a brief overview of our approach to such systems.
Current freelance projects in the category Bot Development
AI agent in Instagram Direct — ManyChat PRO (improvements and new features)
38 USD
dianashuvaloff my t g There is a women's event club HER ERA, ManyChat PRO connected to Instagram. The previous performer gathered a basic flow but with errors — the project needs to be accepted and brought to a working state.What to fix:Remove mentions of packages and… AI & Machine Learning, Bot Development ∙ 7 hours 7 minutes back ∙ 10 proposals |
Need a bot developer (BAS / Python) for automating a loyalty website.
136 USD
I'm looking for an experienced developer to create a bot that will automate registration and bonus collection on the website (loyalty program). What the bot should do: Full automation of the process: from registration to receiving the result (voucher). Work with SMS services… Python, Bot Development ∙ 9 hours 59 minutes back ∙ 18 proposals |
It is necessary to develop a Telegram bot for monitoring cars from auctions in the USA (Copart, IAAI)A Telegram bot is needed for automatic searching and monitoring of "BUY IT NOW" cars at auctions in the USA (Copart, IAAI). The bot should operate automatically and send notifications about new cars that meet the specified filters.Main functionalityFilter settings: 1. Car… Data Parsing, Bot Development ∙ 20 hours 21 minutes back ∙ 69 proposals |
Telegram bot
53 USD
I need code for a Telegram bot that will take messages from one channel, modify them to fit my design, and post them in two other channels. In one channel, from 1 to 6 posts, and in the other channel, all posts. Bot Development ∙ 1 day 10 hours back ∙ 78 proposals |
I am looking for a strong specialist in trading bots and agents.
250 USD
It is important to start - TODAY I need a person who has experience in writing trading bots on DEXs (needed on the BSC network) with an understanding of transaction costs, gas, etc. I want to test several trading strategies on a real trading agent I need to quickly… Cryptocurrency & Blockchain, Bot Development ∙ 2 days 7 hours back ∙ 29 proposals |