Telegram бот + ЮKassa: как подключить приём платежей — инструкция и код

ЮKassa (бывшая Яндекс.Касса) — платёжная система для приёма онлайн-платежей. Подключение к Telegram боту позволяет клиентам оплачивать товары и услуги прямо в чате — без перехода на сторонний сайт.

Процесс оплаты для клиента занимает 15-30 секунд:

1. 1.Клиент выбирает товар/услугу в боте
2. 2.Нажимает «Оплатить»
3. 3.Бот отправляет ссылку на оплату (или встроенный платёж)
4. 4.Клиент вводит данные карты → подтверждает
5. 5.Бот получает уведомление об успешной оплате
6. 6.Клиент получает подтверждение + товар/доступ

Техническая схема

Важно: Telegram поддерживает два способа оплаты: - Telegram Payments (встроенный) — карта вводится прямо в Telegram - Внешняя ссылка — переход на страницу ЮKassa

Встроенный способ удобнее, но требует одобрения Telegram. Внешняя ссылка работает всегда.

Шаг 1: Регистрация в ЮKassa (1-2 дня)

1. 1.Зайдите на yookassa.ru
2. 2.Зарегистрируйтесь как ИП или ООО
3. 3.Загрузите документы (ИНН, ОГРНИП, паспорт)
4. 4.Дождитесь верификации (1-2 дня)
5. 5.Получите shopId и secretKey

Шаг 2: Настройка бота (2-3 дня)

1. 1.Создайте товары/услуги в боте
2. 2.Реализуйте корзину (выбор → количество → итого)
3. 3.Подключите API ЮKassa
4. 4.Настройте webhook для уведомлений
5. 5.Реализуйте обработку статусов платежа

Шаг 3: Тестирование (1 день)

1. 1.Используйте тестовый режим ЮKassa
2. 2.Пробные платежи тестовыми картами
3. 3.Проверьте все сценарии: успех, ошибка, возврат
4. 4.Проверьте уведомления клиенту

Шаг 4: Запуск (1 день)

1. 1.Переключите ЮKassa на боевой режим
2. 2.Проведите реальный платёж
3. 3.Проверьте поступление на расчётный счёт

Вот минимальный рабочий пример интеграции ЮKassa с Telegram ботом на aiogram:

Установка зависимостей

 1pip install aiogram yookassa

Создание платежа

 1import yookassa
 2from yookassa import Configuration, Payment
 3
 4Configuration.account_id = "ВАШ_SHOP_ID"
 5Configuration.secret_key = "ВАШ_SECRET_KEY"
 6
 7async def create_payment(amount, description):
 8    payment = Payment.create({
 9        "amount": {"value": str(amount), "currency": "RUB"},
10        "confirmation": {
11            "type": "redirect",
12            "return_url": "https://t.me/your_bot"
13        },
14        "capture": True,
15        "description": description
16    })
17    return payment

Обработка webhook

 1from aiogram import Router
 2from aiohttp import web
 3
 4router = Router()
 5
 6async def yookassa_webhook(request):
 7    event = await request.json()
 8    if event["event"] == "payment.succeeded":
 9        payment_id = event["object"]["id"]
10        # Выдать товар/доступ клиенту
11        await grant_access(payment_id)
12    return web.Response(status=200)

Отправка кнопки оплаты

 1from aiogram.types import InlineKeyboardMarkup, InlineKeyboardButton
 2
 3async def send_payment_link(chat_id, payment):
 4    keyboard = InlineKeyboardMarkup(inline_keyboard=[
 5        [InlineKeyboardButton(
 6            text="Оплатить",
 7            url=payment.confirmation.confirmation_url
 8        )]
 9    ])
10    await bot.send_message(
11        chat_id,
12        f"Сумма: {payment.amount.value} ₽",
13        reply_markup=keyboard
14    )

В Telegram можно принимать оплату через несколько систем. Вот сравнение:

Рекомендация: - ЮKassa — лучший выбор для ИП/ООО в России. Низкая комиссия, быстрая верификация, надёжность. - Robokassa — если нужна мультивалюта или поддержка самозанятых. - Telegram Stars — для микроплатежей (донаты, подписки, цифровые товары). Высокая комиссия, но не нужен расчётный счёт.

Кейс 1: Онлайн-школа йоги

Результат: Конверсия в оплату выросла на 95%. Клиентам удобно платить сразу в боте — не нужно копировать реквизиты и переходить в банковское приложение.

Кейс 2: Магазин одежды в Telegram

Результат: Бот с каталогом и оплатой через ЮKassa заменил интернет-магазин. Экономия на разработке сайта: 80 000-150 000 ₽.

Кейс 3: Запись на мероприятия

Заказать бота с оплатой — подключу ЮKassa за 3-5 дней.

Безопасность — главный вопрос клиентов. Вот как защитить платёжную систему:

Требования безопасности

Частые ошибки разработчиков

Чеклист перед запуском

• ›[ ] ЮKassa переключена на боевой режим
• ›[ ] Проведён реальный платёж
• ›[ ] Деньги поступили на расчётный счёт
• ›[ ] Клиент получил подтверждение в боте
• ›[ ] Webhook обрабатывает все статусы
• ›[ ] Логирование работает
• ›[ ] Нет двойных списаний

Три причины подключить ЮKassa к Telegram боту:

1. 1.Конверсия в оплату +95%. Клиент платит в 2 клика — не нужно копировать реквизиты.
2. 2.Автоматизация. Бот сам подтверждает оплату, отправляет товар/доступ, уведомляет менеджера.
3. 3.Безопасность. ЮKassa — лицензированный платёжный агент. Данные карт хранятся на их серверах.

Стоимость подключения: от 20 000 ₽ (разработка) + 2.8-3.5% комиссия ЮKassa. Сроки: 5-8 дней от регистрации до запуска.

Статьи по теме: - Telegram бот с оплатой — обзор всех способов оплаты - Стоимость Telegram бота: 7 факторов — из чего складывается цена - ROI Telegram бота — как рассчитать окупаемость

Пошаговый процесс подключения

Подключение ЮKassa к Telegram-боту занимает 5-8 рабочих дней и состоит из нескольких этапов. Первый этап — регистрация в ЮKassa. Нужны документы ИП или ООО: ИНН, ОГРНИП или ОГРН, паспорт, реквизиты банковского счёта. Регистрация занимает 1-2 рабочих дня. ЮKassa проверяет документы и активирует аккаунт.

Второй этап — получение API-ключей. После регистрации вы получаете shopId и secretKey. Эти ключи нужны для интеграции с ботом. Хранить их нужно в переменных окружения, ни в коем случае не в коде. Если ключи попадут в публичный репозиторий — злоумышленники смогут создавать фейковые платежи.

Третий этап — разработка платёжного модуля. Это самая объёмная часть. Нужно реализовать: создание платежа, обработку callback от ЮKassa, подтверждение оплаты, отправку товара или доступа клиенту, уведомление менеджера. На Python с библиотекой aiogram это занимает 2-3 дня.

Четвёртый этап — тестирование. ЮKassa предоставляет тестовый режим. Можно создавать тестовые платежи и проверять весь цикл без реальных денег. Важно протестировать: успешную оплату, отклонённую оплату, возврат, частичный возврат, таймаут оплаты.

Как увеличить конверсию в оплату

Конверсия в оплату зависит от нескольких факторов. Первый — скорость. Если клиент нажал «Оплатить» и видит форму оплаты через 3 секунды — конверсия 70%. Если ждёт 10 секунд — 40%. Оптимизируйте время создания платежа: кэшируйте данные, используйте асинхронные вызовы.

Второй фактор — количество шагов. Идеально: нажал кнопку, ввёл данные карты, оплата. Если между шагами есть подтверждения, перенаправления, дополнительные экраны — теряете 20-30% клиентов на каждом шаге.

Третий фактор — уведомления. После оплаты клиент должен получить мгновенное подтверждение: «Оплата получена! Вот ваш товар или доступ». Если подтверждение приходит через 5 минут — клиент уже написал в поддержку и разочаровался.

Типичные ошибки при интеграции

Первая ошибка: не обрабатывать webhook от ЮKassa. Если сервер упал и не принял webhook — платеж будет висеть в статусе «ожидает подтверждения». Клиент заплатил, но не получил товар. Решение: регулярная проверка статуса платежей через API.

Вторая ошибка: хранить данные карт на своём сервере. Это нарушение PCI DSS и риск утечки. ЮKassa хранит данные карт на своих серверах — вы получаете только токен. Используйте токен для повторных списаний.

Третья ошибка: не обрабатывать частичные возвраты. Если клиент вернул часть заказа — нужно вернуть часть суммы. ЮKassa поддерживает частичные возвраты через API. Без этой функции вы теряете время на ручные возвраты и рискуете получить негативный отзыв.