VibeCoderzVibeCoderz
Все статьи
Вайбкодинг: гайды2026/06/2412 мин чтения

Как подключить оплату к Telegram-боту в 2026 ЮKassa Stars и Telegram Payments

Новый способ оплаты в Telegram‑боте: ЮKassa для рублей, Telegram Stars для цифровых товаров и Payments 2.0 как единый API, позволяющий быстро и без лишних строк кода интегрировать обе системы.

Содержание (9)+

Обновлено: октябрь 2026.

Подключить оплату к Telegram-боту в 2026 можно тремя способами: ЮKassa для рублей через провайдер-токен, Telegram Stars для цифровых товаров через валюту XTR, Telegram Payments 2.0 как общий каркас под оба варианта. Технически это 30-50 строк кода на aiogram 3 и десять минут настройки в BotFather. Ниже разбираем когда что брать, какие промпты давать Windsurf и на каких ошибках чаще всего спотыкается интеграция.

TL;DR. Хотите создать бота для продажи физического товара или услуги за рубли, берите ЮKassa. Продаете доступ к контенту, подписку, цифровой продукт внутри Telegram, обязаны использовать Stars (правила платформы). Telegram Payments 2.0 это API-слой, через который оба способа подключаются одинаковым кодом: send_invoice, pre_checkout_query, successful_payment.

Какие три способа оплаты работают в Telegram-боте сейчас

Три варианта закрывают 95% задач: ЮKassa для рублей и физических товаров, Telegram Stars для цифрового контента внутри Telegram, Payments 2.0 как унифицированное API над обоими.

Bot Payments API от Telegram это посредник между ботом, пользователем и платежной системой. Сам Telegram деньги не держит и комиссию с разработчика не берет: всю работу с картами выполняет провайдер вроде ЮKassa, а Stars обрабатываются внутри экосистемы Telegram через Fragment с выводом в TON. Источник: core.telegram.org/bots/payments.

Базовая логика одна для всех трех способов. Бот вызывает метод send_invoice с описанием товара и ценой, Telegram показывает пользователю нативное окно оплаты, после транзакции бот получает событие successful_payment и выдает продукт. Различия в одном поле: currency и provider_token.

Для ЮKassa: currency="RUB", provider_token берется в боте провайдера. Для Stars: currency="XTR", провайдер-токен пустой. Telegram Payments 2.0 это апдейт API 7.4+, который добавил подписки через Stars, повтор инвойсов и расширенную работу с возвратами. Под капотом тот же send_invoice.

СпособВалютаProvider tokenПод что подходитКомиссия
ЮKassaRUBНуженФизтовары, услуги, рубли3-3.5% с оборота
Telegram StarsXTRНе нуженЦифровой контент внутри TelegramПочти 0% при выводе в TON
CryptoBotUSDT/TON/BTCНужен стороннийКриптовалюта, зарубежные клиенты0-3%
RobokassaRUBНуженАльтернатива ЮKassaот 2.5%
Изображение

Как настроить оплату через ЮKassa в боте на aiogram 3

ЮKassa подключается через токен из BotFather. Сумма передается в копейках, тестовый режим работает без ИП. Обработка платежа закрывается двумя хэндлерами: pre_checkout_query и successful_payment.

Тестовый provider_token у ЮKassa получается за пять минут через диалог с ботом ЮKassa в самом Telegram. Боевой токен требует подтвержденного статуса ИП, ООО или самозанятого. Лимит тестового режима 1000 рублей за платеж, для отладки воронки этого хватает с запасом.

Алгоритм подключения на aiogram 3.13+ выглядит так. Откройте @BotFather, зайдите в /mybots, выберите своего бота, Payments, в списке найдите ЮKassa Test. Бот сам перенаправит в чат с @YooKassaBot, который выдаст токен формата 381764678:TEST:104387. Эту строку положите в .env как YOOKASSA_TOKEN.

Изображение

В коде бота send_invoice вызывается с одним обязательным условием: цена в копейках. 500 рублей это 50000. Это типовой баг новичков. Ставят 500 в коде, получают платеж на 5 рублей и думают, что ЮKassa глючит. Платежные системы работают в минимальных единицах валюты, чтобы избежать ошибок округления.

from aiogram import Bot
from aiogram.types import LabeledPrice

await bot.send_invoice(
    chat_id=user_id,
    title="Курс по вайбкодингу",
    description="7 модулей, доступ навсегда",
    payload="course_vibecoderz_2026",
    provider_token=YOOKASSA_TOKEN,
    currency="RUB",
    prices=[LabeledPrice(label="Курс", amount=890000)],  # 8900 рублей
)

Дальше два обязательных хэндлера. pre_checkout_query приходит за 10 секунд до списания, бот отвечает True или False. successful_payment срабатывает после реального списания, тут уже выдается доступ к продукту и пишется запись в базу.

Чем отличаются Telegram Stars и Telegram Payments 2.0 в 2026

Stars это внутренняя валюта Telegram (XTR), Payments 2.0 это сам API над платежами. Все цифровые товары в боте теперь обязательно идут через Stars, иначе бан по правилам платформы.

С 2024 года Telegram обновил правила для ботов: цифровые товары и услуги внутри Telegram можно продавать только за Stars. ЮKassa и другие провайдеры остаются для физических товаров и услуг вне платформы (доставка, билеты, физические курсы). За продажу цифрового контента за рубли через ЮKassa бот блокируется без предупреждения.
Изображение

Stars устроены просто. Пользователь покупает их через Apple IAP, Google Play или @PremiumBot. Курс в среднем 1.5-2 рубля за одну звезду в зависимости от стора. Бот принимает Stars через стандартный send_invoice с одной заменой: currency="XTR", provider_token="". Никаких сторонних провайдеров.

await bot.send_invoice(
    chat_id=user_id,
    title="Premium доступ",
    description="30 дней безлимита",
    payload="premium_30d",
    provider_token="",  # для Stars пусто
    currency="XTR",
    prices=[LabeledPrice(label="Подписка", amount=500)],  # 500 звезд
)

Бот для продажи звезд в чистом виде, как продукт, делать не нужно: Stars нельзя перепродавать, это нарушение правил. Зато бот, который принимает Stars за свои товары, это норма. Подписки через subscription_periodпоявились в Payments 2.0 в 2025 и закрывают модель SaaS: пользователь оплатил месяц, через 30 дней Telegram сам пытается списать снова, бот получает уведомление.

Telegram Payments 2.0 принципиально упростил три вещи: подписки через Stars (без CRM сбоку), повторные инвойсы по invoice_link, единый возврат через refundStarPayment. Если делаете подписочный продукт на цифровом контенте внутри Telegram, в 2026 это де-факто единственный нормальный путь.

Какой промпт дать Windsurf чтобы получить рабочую оплату с первого раза

Промпт-PRD из шести блоков: стек, FSM-состояния, объект Invoice, хэндлеры pre_checkout и successful_payment, переменные окружения, тесты. Без указания версии aiogram 3.13+ агент часто пишет код от aiogram 2.

Windsurf и Cursor берут модель Claude Sonnet 4.6 или Opus 4.8 как мозг агента (каталог IDE на VibeCoderz). Модель обучена на смеси aiogram 2 и aiogram 3. Без явного указания версии в промпте получаете архитектуру 2018 года, с lambda-фильтрами и ручным bot=Bot(token). Полчаса теряете на переписывание.
Изображение

Рабочий промпт под оплату через ЮKassa в Windsurf выглядит так. Открываете Cascade, переключаете на Claude Sonnet 4.6, вставляете:

Создай Telegram-бот для продажи [название продукта] на aiogram 3.13+.
Стек: Python 3.11, aiogram 3.13, aiosqlite, python-dotenv.

FSM-состояния:
- start (главное меню, две кнопки "Купить" и "Что внутри")
- show_details (описание продукта, кнопка "Оплатить")
- payment (отправка invoice через ЮKassa)
- access_granted (выдача доступа после successful_payment)

Платежи через ЮKassa, токен в .env как YOOKASSA_TOKEN.
Сумма в копейках, currency RUB.
Хэндлер pre_checkout_query отвечает True.
Хэндлер successful_payment пишет запись в SQLite (user_id, payload, amount, created_at).
После оплаты бот отправляет инструкцию доступа к продукту.

База данных: aiosqlite с таблицей payments (id, user_id, payload, amount, status, created_at).
.env с BOT_TOKEN, YOOKASSA_TOKEN, ADMIN_ID.
README с инструкцией запуска.

Этого хватает Windsurf чтобы собрать рабочий MVP за один прогон. На выходе получаете 200-300 строк кода с разбивкой по handlers/, states/, keyboards/, db.py. Дальше остается прогнать тестовую оплату и поменять текст под себя.

Если делаете под Telegram Stars, в промпте меняете: вместо ЮKassa указываете currency XTR, provider_token пустой строкой. И добавляете subscription_period=2592000 если нужна подписка на 30 дней. Остальное идентично.

Какие баги ловят чаще всего при интеграции платежей в Telegram-бот

Топ-5 ошибок: сумма в рублях вместо копеек, забытый ответ на pre_checkout_query, тестовый токен в продакшене, отсутствие protect_content, отсутствие идемпотентности на successful_payment.

Эти пять багов закрывают 80% жалоб разработчиков в чате aiogram. Они не зависят от стека, провайдера или модели: всплывают одинаково на ЮKassa, Stars и Robokassa. Проверять при первой интеграции по списку, экономит часы дебага.
Изображение

Разбор по порядку.

  • Сумма не в копейках. В prices=[LabeledPrice(label=..., amount=...)] передается целое число в минимальных единицах валюты. 100 рублей это 10000, не 100. Bug-репорт «ЮKassa списала 1 рубль вместо 100» в 9 случаях из 10 это оно.
  • Молчание на pre_checkout_query. Telegram дает 10 секунд на ответ True или False. Если бот не успел, платеж отменяется на стороне Telegram, деньги клиенту возвращаются. Долгие проверки в этом хэндлере не пишите, чек инвентаря делайте до отправки инвойса.
  • Тестовый токен в продакшене. Тестовый provider_token ЮKassa содержит подстроку :TEST:. Клиент платит реальной картой, получает ошибку «Tеst payments are not available». Перед деплоем проверка одной строкой: assert ":TEST:" not in YOOKASSA_TOKEN.
  • Отсутствие protect_content в send_invoice. Без этого флага инвойс пересылается в любой чат и оплачивается там же. Кто-то платит, получает доступ. Не тот, кто должен. Добавляйте protect_content=True всегда.
  • Нет идемпотентности на successful_payment. При плохой сети Telegram может прислать successful_payment дважды. Без проверки payload в базе бот выдаст доступ два раза, либо создаст две записи. Решается unique-индексом на telegram_payment_charge_id.

Шестая ошибка отдельно для Stars: попытка продавать звезды как товар. По правилам это запрещено и бот блокируется через 24-48 часов. Если делаете бот для продажи звезд, держите в голове: это не отдельный продукт, это валюта внутри Telegram-экосистемы.

Когда брать ЮKassa а когда Telegram Stars для своего бота

ЮKassa берется когда продаете физтовар, услугу офлайн, доступ к сайту вне Telegram. Stars берутся когда продаете цифровой контент или подписку внутри Telegram. Третьего варианта правила не дают.

Логика выбора простая. Если товар физически уходит клиенту (мерч, оборудование, продукт) или услуга оказывается вне Telegram (доставка, консультация, курс на отдельной платформе), ЮKassa единственный нормальный вариант. Цифровой контент в самом Telegram, доступ к боту, премиум-фичи, подписки на каналы, тут только Stars.
Изображение

Что не очевидно из доков. Курс на YouTube или Notion это не «внутри Telegram», даже если ссылка приходит через бота. Доступ к закрытому Telegram-каналу формально цифровая услуга, но Telegram пока не штрафует за продажу такого доступа через ЮKassa. Серая зона, держите ее в уме.

СценарийСпособПочему
Доставка пиццы через ботаЮKassaФизтовар, рубли удобнее клиенту
Доступ к курсу на сайтеЮKassaУслуга оказывается вне Telegram
Подписка на премиум-функции ботаStarsЦифровая услуга внутри Telegram
Покупка стикеров или гифокStarsКонтент внутри платформы
Бронирование консультацииЮKassaУслуга в Zoom, не в Telegram
Чаевые автору контентаStarsТранзакция внутри платформы
Продажа товара на маркетплейсеЮKassaФизтовар с доставкой
Доступ к закрытому чатуStars или ЮKassaСерая зона, на свой риск
Максим: «На NanaBanana мы изначально подключили ЮKassa, потому что продавали "генерацию фото в Telegram" как цифровую услугу. В 2024 правила Telegram поменялись, и я за два дня переписал биллинг на Stars. Это около 50 строк кода. Бот в Telegram даже не заметил, что я что-то поменял: 80 000+ подписчиков продолжали платить, выручка 12 миллионов рублей за 7 месяцев, ноль рублей в рекламу. Сделал и получил цифру.»

Сколько стоит запустить бота для продаж с оплатой и за сколько окупается

Технически запуск стоит 0 рублей: тестовая ЮKassa бесплатна, Stars не требуют провайдера, Railway дает $5 кредитов в месяц, Supabase бесплатно до 500 МБ. Окупаемость от первой оплаты, дальше вопрос трафика.

По данным Telegram, к 2026 году платежи через Bot API проходят у 1.4 млрд активных пользователей в месяц. Это не значит, что вам автоматически достается доля. Но порог входа реально нулевой: BotFather, токен ЮKassa, Railway-деплой, и оплата уже работает на тестовом стенде.

Бюджет первого месяца разложен в таблице ниже. Это реальные цифры с продакшена нашего ученика, который делал бот для продажи фото-пресетов в марте 2026.

СтатьяСтоимостьКомментарий
BotFather + ЮKassa тест0 ₽Бесплатно, без ИП
Railway hosting$5/месКредит на старте, дальше $5-10
Supabase0 ₽Free tier 500 МБ
Claude Sonnet 4.6 для Windsurf$20/месПодписка, не pay-per-use
Регистрация ИП800 ₽Только когда переходите на боевой ЮKassa
Итого первый месяц~2000 ₽С учетом курса доллара

Окупаемость считается от первого заказа. У ученика Юркевича бот окупился за 12 дней: 7 оплат по 3000 рублей, итого 21 000 рублей при затратах 2000. На втором месяце выручка 47 000, к третьему 110 000. Без рубля рекламы, через канал автора в Telegram.

Изображение

Принцип трех единичек работает и тут. Один сегмент (например, фотографы на iPhone), одна задача (пресеты для съемки еды), одна функция (бот выдает пресеты после оплаты). Бот «продает все подряд» это размытое позиционирование, которое плохо продается. Создать бота для продажи имеет смысл когда у вас есть конкретный продукт и понятная аудитория.

FAQ

Можно ли подключить оплату к Telegram-боту без ИП и юрлица?

В тестовом режиме ЮKassa и в Telegram Stars это работает без юридического оформления. Боевой provider_token ЮKassa требует ИП, ООО или статус самозанятого. Stars подключаются через личный аккаунт разработчика, без бумаг. Вывод заработанных Stars идет через Fragment в TON, оттуда через крипто-обменник в рубли. Для официальной выручки и налогов после первых 100 000 в месяц лучше открыть самозанятость, это 1 час в приложении «Мой налог».

Что лучше для бота с цифровыми товарами Stars или ЮKassa?

По правилам Telegram цифровой контент внутри платформы продается только за Stars. ЮKassa в этом сценарии нарушение TOS, бот блокируется без предупреждения. Stars не имеют комиссии с разработчика при выводе в TON. Минус Stars: пользователь сначала покупает их через Apple IAP или PremiumBot, а это лишний шаг. Если ваша аудитория уже сидит в Telegram и привыкла к Stars, проблемы нет. Если люди приходят с улицы, ЮKassa проще.

Какая комиссия у Telegram Stars при выводе средств в 2026?

Сам Telegram комиссию с разработчика при выводе Stars в TON через Fragment почти не берет. Реальная цена для покупателя выше из-за наценки Apple и Google в их IAP, но это маржа сторов, а не комиссия с вашей выручки. На круг разработчик получает примерно $0.013 за каждую Star (около 1 рубля по курсу июня 2026). Для подписочной модели это работает в плюс: нет 3.5% эквайринга как у ЮKassa.

Сколько стоит запустить бота для продаж с оплатой?

Технически ноль рублей. BotFather бесплатен, тестовая ЮKassa бесплатна, Railway дает $5 кредитов в месяц новым аккаунтам, Supabase бесплатен до 500 МБ. Боевой запуск держится в 0-500 рублей в месяц первые полгода. С масштабом до 10 000 пользователей в месяц расходы вырастают до 3-5 тысяч рублей: Railway уже $20-30, плюс Redis для FSM, плюс мониторинг. Reklamу при этом тратить не надо, если идете через SEO и каталоги (каталог Telegram-ботов на VibeCoderz).

Можно ли принимать оплату криптой в Telegram-боте?

Да, через сторонние шлюзы: CryptoBot, CryptoCloud, NOWPayments. Они принимают USDT, TON, BTC, ETH. Подключаются как сторонний провайдер, не через нативный Bot Payments API. Комиссия 0-3%, нет требований к юрлицу. Подходит для зарубежной аудитории и клиентов без российских карт. Минус: не все пользователи понимают как платить криптой, конверсия ниже чем у ЮKassa в России. Лучше держать оба варианта параллельно.

Что делать если successful_payment не приходит а деньги списались?

Сначала проверьте логи на хэндлере pre_checkout_query. Если ответ True не ушел за 10 секунд, Telegram сам отменит платеж и деньги вернутся клиенту в течение 24 часов. Если ответ ушел, но successful_payment не пришел, проверьте вебхук на стороне бота (если работаете в webhook-режиме) или сетевое соединение. ЮKassa возвращает платеж клиенту автоматически через 24 часа, если бот не подтвердил доставку. Telegram Stars в такой ситуации остаются у Telegram до ручного решения через refundStarPayment.

Где смотреть аналитику по платежам в Telegram-боте?

Для ЮKassa: личный кабинет на yookassa.ru. Там видны все транзакции, чарджбэки, выручка по дням. Для Stars: @PremiumBot показывает баланс ваших звезд и историю поступлений. Для агрегации обоих ставят свою таблицу в Supabase или Google Sheets через webhook, в которую пишутся события successful_payment. Дальше уже строится дашборд в Metabase или Looker Studio, чтобы видеть выручку, средний чек, ARPU, LTV. Без этого слоя продукт растет вслепую.

Изображение

Что делать дальше

Если разобрались с теорией, дальше путь короткий. Откройте каталог IDE для вайбкодинга на VibeCoderz, выберите Windsurf или Cursor (оба работают одинаково хорошо для Telegram-ботов), поставьте Claude Sonnet 4.6 как основную модель. Скопируйте промпт-PRD из этой статьи, замените описание продукта на свое, прогоните через агент. Через 30-60 минут у вас рабочий MVP бота с оплатой через ЮKassa или Stars.

Если хотите ускорить путь и получить разбор именно вашей идеи, запишитесь на консультацию к Максиму. Он прошел этот путь от первого бота до NanaBanana с 200 000+ пользователей и 12 миллионами выручки без рубля в рекламу. На звонке разбираем нишу, продукт, монетизацию, технический стек и план запуска.


Обновлено: октябрь 2026. VibeCoderz, крупнейший русскоязычный каталог AI-инструментов, IDE и материалов для вайбкодинга. Авторы: Максим и Елисавета Наговицыны.

Автор

Максим Наговицын

Маркетинг-стратег, IT-предприниматель, ментор по вайбкодингу

2026/06/24

10+ лет в маркетинге, 300+ клиентских проектов: сайты, реклама, боты. Создатель GoBanana (228K+ пользователей, 11.6 млн ₽ выручки) и VibeCoderz. Делаю AI-продукты сам через Claude Code, Cursor, Windsurf и консультирую тех, кто хочет так же.

Об авторе →
All Posts

Инструменты, упомянутые в статье

Читать далее

📄 Статья

AI-дашборды 2026 Recharts, Tremor и Supabase за один вечер

Дашборд с рабочими графиками и живыми SQL-запросами к базе собирается за один вечер, если взять связку React плюс Recharts или Tremor плюс Supabase и переложить рутину на AI. Обновлено: август 2026. Ниже разберем весь путь: выбор библиотеки графиков,…

2026/08/188 мин
📄 Статья

Калькулятор окупаемости автоматизации для малого бизнеса: 5 ниш и реальные цифры

Окупаемость автоматизации бизнеса зависит не от инструмента, а от того, с какого процесса вы начали. Розница, услуги, инфобизнес, производство и общепит окупают вложения по-разному: где-то деньги возвращаются за месяц, где-то счет идет на кварталы. Н…

2026/08/129 мин
📄 Статья

Telegram bot token утек что делать в первые 5 минут 2026

Если telegram bot token утек в публичный репозиторий, паника не поможет, зато скорость решает все. У вас есть примерно 5 минут до того, как токен подхватит бот-сканер или живой атакующий. Ниже: что делать по шагам, как проверить бота на признаки взло…

2026/08/048 мин
📄 Статья

env-переменные что это для новичка: куда класть API-ключи чтобы не засветить

ENV-переменные (переменные окружения) - это способ хранить пароли, токены и API-ключи отдельно от кода, в защищенном месте, откуда их не увидит никто, кто просто откроет ваш репозиторий. Простыми словами: вместо того чтобы вписать ключ прямо в файл с…

2026/07/219 мин
📄 Статья

tasks.md для вайбкодинг-проекта: как дробить работу на шаги, чтобы агент не терял нить

tasks.md для проекта это файл бэклога, который ai-агент читает и обновляет, пока строит ваш продукт. В нем лежат задачи со статусом, приоритетом и критериями готовности. Агент видит, что уже сделано, что заблокировано и за что браться дальше. Без так…

2026/07/138 мин
📄 Статья

CLAUDE.md и AGENTS.md: как настроить AI-агента для своего pet project

Оптимизируйте настройку AI-агента всего за пару минут: добавьте в корень репозитория CLAUDE.md или AGENTS.md с инструкциями, и ваш агент сразу поймет стек, структуру и правила проекта.

2026/07/078 мин