Создайте файл и впишите в него следующий код:
Для полной реализации осталось:
stars_payment_module.py
pythonimport logging
from aiogram import Bot, types, Router, FSMContext
from aiogram.filters import Command, StateFilter
from aiogram.fsm.state import State, StatesGroup
from aiogram.types import InlineKeyboardButton, InlineKeyboardMarkup
from typing import Dict, Any
# ---- States Machine ----
class PaymentStates(StatesGroup):
WAITING_PAYMENT = State()
# ---- Config ----
MAX_DAILY_STARS = 100000 # Лимит Stars/день
CURRENCY = "USD" # Валюта по умолчанию
# ---- Core Functions ----
class StarsPaymentSystem:
def __init__(self, bot: Bot):
self.bot = bot
self.router = Router()
self._register_handlers()
self.user_balances: Dict[int, int] = {} # Временное хранилище (замените на БД)
def _register_handlers(self):
self.router.message.register(self.cmd_topup, Command("topup"))
self.router.callback_query.register(
self.process_buy_stars,
lambda c: c.data.startswith("buy_stars:")
)
self.router.pre_checkout_query.register(self.pre_checkout)
self.router.message.register(
self.successful_payment,
types.ContentType.SUCCESSFUL_PAYMENT
)
# ---- Handlers ----
async def cmd_topup(self, message: types.Message):
"""Показывает варианты пополнения Stars"""
options = await self._get_topup_options()
if not options:
await message.answer("⚠️ Пополнение временно недоступно")
return
keyboard = InlineKeyboardMarkup(inline_keyboard=[
[InlineKeyboardButton(
text=f"{opt['stars']} Stars за {opt['amount']/100} {opt['currency']}",
callback_data=f"buy_stars:{opt['stars']}:{opt['currency']}:{opt['amount']}"
)] for opt in options
])
await message.answer(
"✨ Выберите пакет Stars:",
reply_markup=keyboard
)
async def process_buy_stars(
self,
callback: types.CallbackQuery,
state: FSMContext
):
"""Обрабатывает выбор пакета Stars"""
_, stars, currency, amount = callback.data.split(':')
await state.update_data(
stars=int(stars),
currency=currency,
amount=int(amount)
)
await state.set_state(PaymentStates.WAITING_PAYMENT)
payment_url = await self._generate_payment_link(
stars=stars,
currency=currency,
amount=amount
)
await callback.message.edit_text(
f"💳 Для оплаты {stars} Stars перейдите по ссылке:\n\n{payment_url}",
reply_markup=InlineKeyboardMarkup(inline_keyboard=[[
InlineKeyboardButton(text="✅ Я оплатил", callback_data="check_payment"),
InlineKeyboardButton(text="❌ Отмена", callback_data="cancel_payment")
]])
)
async def successful_payment(self, message: types.Message, state: FSMContext):
"""Обрабатывает успешный платеж"""
payment_data = message.successful_payment.to_python()
user_id = message.from_user.id
# Обновляем баланс
stars_added = payment_data['total_amount'] // 100 # Пример: 100 Stars за $1
self.user_balances[user_id] = self.user_balances.get(user_id, 0) + stars_added
await message.answer(
f"🎉 Вы получили {stars_added} Stars!\n"
f"💰 Текущий баланс: {self.user_balances[user_id]} Stars"
)
await state.clear()
# ---- Service Methods ----
async def _get_topup_options(self) -> list[Dict[str, Any]]:
"""Получает варианты пополнения от Telegram"""
async with self.bot.session as session:
response = await session.post(
f"https://api.telegram.org/bot{self.bot.token}/payments.getStarsTopupOptions"
)
data = await response.json()
return data.get('result', [])
async def _generate_payment_link(
self,
stars: int,
currency: str,
amount: int
) -> str:
"""Генерирует платежную ссылку"""
async with self.bot.session as session:
response = await session.post(
f"https://api.telegram.org/bot{self.bot.token}/payments.getPaymentForm",
json={
"invoice": {
"@type": "inputInvoiceStars",
"purpose": {
"@type": "inputStorePaymentStarsTopup",
"stars": int(stars),
"currency": currency,
"amount": int(amount)
}
}
}
)
data = await response.json()
return data['result']['invoice']['payment_url']
# ---- Integration Example ----
async def setup_payments(bot: Bot, dp: Dispatcher):
payment_system = StarsPaymentSystem(bot)
dp.include_router(payment_system.router)📌 Функционал по столбцам
| Компонент | Технологии/Методы | Что делает |
|---|---|---|
| StatesGroup | aiogram.fsm | Управляет состоянием пользователя во время платежа |
| Payment Handlers | pre_checkout_query, successful_payment | Обрабатывает события платежной системы Telegram |
| API Requests | aiohttp.ClientSession | Делает запросы к Telegram BOT API для работы с Stars |
| Баланс | Временный словарь user_balances | Хранит баланс Stars (в продакшене замените на Redis/PostgreSQL) |
| Клавиатуры | InlineKeyboardMarkup | Интерактивные кнопки для выбора пакета Stars и управления платежом |
🛠 Интеграция в основной бот
- В файле main.py добавьте:
from stars_payment_module import setup_payments
async def main():
bot = Bot(TOKEN)
dp = Dispatcher()
await setup_payments(bot, dp) # Инициализация платежей
# ... другие роутеры
await dp.start_polling(bot)
[LIST=1]
[*]Обязательные настройки в @BotFather:
[LIST]
[*]Включите [B]Payments[/B] в настройках бота
[*]Укажите [B]Currency[/B] (например, USD)
[*]Настройте [B]Payments Provider[/B] (если требуется)
[/LIST]
[/LIST]
[HR][/HR]
[HEADING=3]🚀 Дополнительные улучшения[/HEADING]
[LIST=1]
[*][B]Логирование платежей[/B]:
[/LIST]
python
logging.basicConfig(
format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
level=logging.INFO,
filename='payments.log'
)
[LIST=1]
[*][B]Проверка лимитов[/B]:
[/LIST]
python
async def _check_limits(user_id: int, stars: int) -> bool:
daily_spent = await get_daily_spent(user_id) # Ваша функция к БД
return (daily_spent + stars) <= MAX_DAILY_STARS- Уведомления админа:
async def _notify_admin(user: types.User, amount: int):
await bot.send_message(
ADMIN_ID,
f"💰 Новый платеж!\n"
f"👤 {user.full_name} (@{user.username})\n"
f"💎 +{amount} Stars"
)Для полной реализации осталось:
- Подключить вашу БД для хранения баланса
- Настроить обработку возвратов (refunds)
- Добавить тесты (pytest)