Как подключить оплату в Telegram Mini App: ЮKassa, Stripe, крипто

Подключение оплаты -- ключевой этап запуска коммерческого Mini App. Telegram предлагает несколько способов приема платежей: через встроенный Payments API с провайдерами (ЮKassa, Stripe и другие), через TON-кошелек, через внешнюю платежную страницу. Выбор зависит от вашей аудитории, географии и типа бизнеса. В этой статье мы разберем каждый способ пошагово: от регистрации у провайдера до обработки webhook-уведомлений. Все инструкции актуальны на февраль 2026 года с учетом последних обновлений Telegram Bot API.

Telegram Payments API -- это встроенный механизм приема платежей через мессенджер. Принцип работы: Mini App формирует данные заказа (товары, суммы) и передает их боту. Бот создает invoice (счет) через метод createInvoiceLink или sendInvoice. Пользователь видит нативную форму оплаты прямо в Telegram, вводит данные карты и подтверждает платеж. Telegram передает данные выбранному платежному провайдеру, провайдер списывает средства и уведомляет вашего бота через pre_checkout_query и successful_payment. Важно: Telegram не хранит данные карт и не берет комиссию за транзакции -- комиссию берет только платежный провайдер. Это делает Payments API одним из самых выгодных каналов приема платежей.

ЮKassa -- основной платежный провайдер для российского рынка. Для подключения: зарегистрируйтесь на yookassa.ru и заполните анкету юрлица или ИП. Срок проверки -- 1-3 рабочих дня. После одобрения получите shopId и секретный ключ. В BotFather выберите вашего бота, перейдите в Payments, выберите ЮKassa и введите токен. В коде бота используйте метод createInvoiceLink с параметром provider_token. Комиссия ЮKassa для Telegram -- от 2,8 процента для банковских карт, от 1,5 процента для электронных кошельков. Минимальный платеж -- 1 рубль. Поддерживаются карты Visa, MasterCard, МИР, а также SberPay и электронные кошельки. Вывод средств -- на расчетный счет юрлица, обычно на следующий рабочий день.

Stripe подходит для международных проектов и аудитории за пределами России. Регистрация на stripe.com, верификация бизнеса занимает от 1 до 5 дней. После получения API-ключей подключите Stripe как провайдера в BotFather. Комиссия Stripe -- 2,9 процента плюс 30 центов за транзакцию для карт, для международных карт дополнительно 1 процент. Stripe поддерживает более 135 валют и все основные платежные методы: Visa, MasterCard, American Express, Apple Pay, Google Pay. Преимущество Stripe -- мощная панель управления с аналитикой, рекуррентными платежами и подписками. Если ваш Mini App предлагает подписочную модель (например, ежемесячная доставка), Stripe -- оптимальный выбор.

TON (The Open Network) -- блокчейн-платформа, созданная командой Telegram. Оплата в TON не использует Payments API, а работает через TON Connect -- протокол подключения криптокошелька. Пользователь нажимает "Оплатить в TON", открывается его кошелек (Tonkeeper, TON Space), он подтверждает транзакцию. Деньги поступают на ваш TON-кошелек мгновенно. Комиссия сети -- менее 0,01 доллара за транзакцию, что делает TON самым дешевым способом приема платежей. Telegram Stars -- внутренняя валюта Telegram, которая конвертируется в TON. Для цифровых товаров (подписки, контент, внутриигровые покупки) Stars -- обязательный способ оплаты по правилам Telegram. Ограничение: не все пользователи имеют криптокошелек, поэтому TON стоит предлагать как дополнительный, а не основной способ оплаты.

После успешной оплаты ваш бот получает событие successful_payment с данными: сумма, валюта, payload заказа, идентификатор платежа от провайдера. Важно правильно обработать этот webhook: проверить сумму (она должна совпадать с ожидаемой), сохранить платеж в базу данных, обновить статус заказа, отправить пользователю подтверждение. Перед списанием средств Telegram отправляет pre_checkout_query -- на этом этапе вы можете отменить платеж, если товар закончился или условия изменились. Ответить нужно в течение 10 секунд, иначе платеж автоматически отклоняется. Реализуйте идемпотентность: если webhook пришел дважды, заказ не должен создаваться повторно. Логируйте все события для разбора спорных ситуаций.

Никогда не передавайте секретные ключи провайдера на клиентскую сторону -- вся работа с платежами идет через backend. Валидируйте данные из Telegram: проверяйте подпись initData, чтобы убедиться, что запрос действительно пришел из Telegram, а не от злоумышленника. Используйте HTTPS для всех эндпоинтов -- Telegram не отправляет webhook на HTTP-адреса. Храните данные транзакций в зашифрованном виде. Не логируйте полные номера карт или CVV -- вам не нужно с ними работать, это делает провайдер. Настройте мониторинг: если количество неудачных платежей резко выросло, это может указывать на проблему с провайдером или попытку мошенничества. Проводите тестовые платежи на тестовых токенах перед запуском в продакшен.

ЮKassa: лучший выбор для российского рынка, комиссия от 2,8 процента, поддерживает все популярные способы оплаты в России, вывод на расчетный счет. Stripe: оптимален для международных проектов, комиссия от 2,9 процента, мощная аналитика и подписки. TON: минимальная комиссия, мгновенные расчеты, но ограниченная аудитория криптопользователей. Telegram Stars: обязательны для цифровых товаров, Telegram забирает 0 процентов при выводе в TON. Наша рекомендация: подключите ЮKassa как основной способ и TON как дополнительный. Для цифрового контента добавьте Stars. Для международных проектов замените ЮKassa на Stripe. Не ограничивайтесь одним способом -- чем больше вариантов оплаты, тем выше конверсия.