Интеграция платежей в Telegram: полное руководство от разработчика

По данным моих проектов, интеграция платежей в Telegram-бота окупается за 2–4 недели. Стоимость разработки: 15 000–30 000 ₽ для существующего бота, от 40 000 ₽ — с нуля.

Интеграция платежей в Telegram-бота нужна:

• ›Интернет-магазинам — каталог, корзина, оплата без сайта
• ›Онлайн-школам — продажа курсов, вебинаров, подписок
• ›Сферам услуг — предоплата за запись (салоны, клиники, фитнес)
• ›Инфобизнесу — продажа цифровых продуктов, консультаций
• ›Малому бизнесу — приём оплаты без эквайринга и сайта

Не нужна интеграция платежей только если вы продаёте услуги дороже 100 000 ₽ с индивидуальным расчётом — там клиент всё равно хочет переговорить с менеджером.

ЮKassa — самый популярный платёжный провайдер для российских Telegram-ботов. Поддерживает карты Visa, Mastercard, МИР, СБП, ЮMoney, SberPay, Tinkoff Pay.

Тарифы: • Карты: 2,8–3,5% от суммы • СБП: 0,4–0,7% (до 300 000 ₽/мес для малого бизнеса — 0%) • ЮMoney: 3,5%

Преимущества для Telegram-ботов: • Встроенная фискализация — чеки формируются автоматически (54-ФЗ) • REST API с отличной документацией • Sandbox для тестирования • Webhook для мгновенных уведомлений о платежах • Поддержка рекуррентных платежей (подписки)

Подключение: нужен ИП или ООО. Регистрация — 1–3 дня. Документы: паспорт, ИНН, выписка из ЕГРЮЛ/ЕГРИП.

В 80% моих проектов используется ЮKassa — это надёжный, проверенный провайдер с простой интеграцией.

Robokassa — агрегатор платёжных систем. Поддерживает 70+ способов оплаты: карты, электронные кошельки, мобильные платежи, терминалы, криптовалюту.

Тарифы: • Карты: 2,5–3,5% • Электронные кошельки: 3–5% • Минимальная комиссия: 15 ₽

Особенности: • Хеш-подпись MD5 или SHA256 для безопасности • Поддержка множества валют • Встроенная фискализация • Простая интеграция через HTTP-запросы

Robokassa — хороший выбор, если нужны альтернативные способы оплаты (кошельки, терминалы) или международные платежи. Подробнее — в статье об интеграции Robokassa.

Stripe — глобальный платёжный провайдер. Поддерживает 135+ валют, карты Visa/Mastercard/AmEx, Apple Pay, Google Pay.

Тарифы: 2,9% + 0,30 $ за транзакцию.

Когда использовать: если клиенты платят в долларах, евро или других валютах. Для российских проектов не подходит (нет поддержки рубля с 2022 года).

В одном из моих проектов — бот для онлайн-школы с международной аудиторией — использовал Stripe для приёма платежей в долларах и евро. Интеграция заняла 2 дня.

Telegram предоставляет встроенный платёжный интерфейс через метод sendInvoice. Пользователь нажимает кнопку «Оплатить», видит привычную форму оплаты прямо в Telegram.

Преимущества: • Не нужно разрабатывать свой интерфейс • Поддержка карт, Apple Pay, Google Pay • Оплата без выхода из Telegram

Ограничения: • Нужен провайдер (ЮKassa, Stripe, Robokassa и др.) • Нельзя настроить полностью свой UI • Ограничения на типы товаров (нельзя продавать алкоголь, табак)

Telegram Payments — отличный вариант для простых сценариев: продажа курсов, подписок, цифровых товаров.

Мой совет: для российского бизнеса — ЮKassa + СБП. Для международного — Stripe. Для максимального выбора способов оплаты — Robokassa.

Пример: интернет-магазин с оборотом 500 000 ₽/мес.

Вывод: СБП экономит до 5 000 ₽/мес при обороте 500 000 ₽. При обороте 2 000 000 ₽ — экономия до 20 000 ₽/мес. Это реальные деньги, которые остаются в бизнесе.

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

Важно: для тестирования используйте sandbox-режим. Ключи sandbox и production — разные. Не смешивайте их.

Необходимые Python-библиотеки:

 1pip install aiogram yookassa aiohttp python-dotenv

Структура проекта:

 1my_payment_bot/
 2├── bot.py              # Основной файл бота
 3├── payments/
 4│   ├── __init__.py
 5│   ├── yookassa_client.py  # Клиент ЮKassa
 6│   └── webhook.py          # Обработка webhook'ов
 7├── config.py           # Конфигурация
 8├── .env                # Переменные окружения
 9└── requirements.txt

Конфигурация (.env):

 1BOT_TOKEN=your_bot_token
 2YOOKASSA_SHOP_ID=your_shop_id
 3YOOKASSA_SECRET_KEY=your_secret_key
 4WEBHOOK_URL=https://your-domain.com/webhook/yookassa

Пример кода для создания платежа через ЮKassa:

 1from yookassa import Configuration, Payment
 2import uuid
 3
 4Configuration.account_id = "ВАШ_SHOP_ID"
 5Configuration.secret_key = "ВАШ_SECRET_KEY"
 6
 7def create_payment(amount: float, description: str, user_id: int):
 8    """Создание платежа в ЮKassa"""
 9    payment = Payment.create({
10        "amount": {
11            "value": f"{amount:.2f}",
12            "currency": "RUB"
13        },
14        "confirmation": {
15            "type": "redirect",
16            "return_url": "https://t.me/your_bot"
17        },
18        "capture": True,
19        "description": description,
20        "metadata": {
21            "user_id": str(user_id),
22            "order_id": str(uuid.uuid4())
23        }
24    }, idempotency_key=str(uuid.uuid4()))
25    
26    return payment

Бот отправляет пользователю ссылку payment.confirmation.confirmation_url — это ссылка на оплату. После успешной оплаты ЮKassa отправляет webhook.

Webhook — уведомление от ЮKassa о статусе платежа. Бот получает его автоматически.

 1from aiohttp import web
 2from yookassa import Webhook, Payment
 3
 4async def handle_yookassa_webhook(request):
 5    """Обработка webhook от ЮKassa"""
 6    data = await request.json()
 7    
 8    if data['event'] == 'payment.succeeded':
 9        payment = data['object']
10        user_id = int(payment['metadata']['user_id'])
11        order_id = payment['metadata']['order_id']
12        
13        # Выдать товар/доступ пользователю
14        await give_access_to_user(user_id, order_id)
15        
16        # Уведомить пользователя
17        await bot.send_message(
18            user_id,
19            "✅ Оплата прошла успешно! Товар доступен."
20        )
21    
22    elif data['event'] == 'payment.canceled':
23        user_id = int(data['object']['metadata']['user_id'])
24        await bot.send_message(
25            user_id,
26            "❌ Оплата не прошла. Попробуйте ещё раз."
27        )
28    
29    return web.Response(status=200)
30
31# Регистрация webhook'а в ЮKassa
32Webhook.add({
33    "event": "payment.succeeded",
34    "url": "https://your-domain.com/webhook/yookassa"
35})

Важно: всегда проверяйте подпись webhook'а. Мошенники могут подделать уведомление и «оплатить» товар без реальных денег.

Пример обработчика команды «Купить» в aiogram:

 1from aiogram import Router, F
 2from aiogram.types import Message, InlineKeyboardMarkup, InlineKeyboardButton
 3
 4router = Router()
 5
 6@router.message(F.text == "🛒 Купить")
 7async def buy_handler(message: Message):
 8    """Обработчик кнопки «Купить»"""
 9    payment = create_payment(
10        amount=1500.00,
11        description="Курс по йоге — базовый уровень",
12        user_id=message.from_user.id
13    )
14    
15    keyboard = InlineKeyboardMarkup(inline_keyboard=[
16        [InlineKeyboardButton(
17            text="💳 Оплатить 1 500 ₽",
18            url=payment.confirmation.confirmation_url
19        )]
20    ])
21    
22    await message.answer(
23        "🛒 **Курс по йоге — базовый уровень**\n\n"
24        "Стоимость: 1 500 ₽\n"
25        "Доступ: навсегда\n\n"
26        "Нажмите кнопку ниже для оплаты:",
27        reply_markup=keyboard,
28        parse_mode="Markdown"
29    )

Это минимальный рабочий пример. В реальном проекте добавьте: обработку ошибок, таймауты, повторные попытки, логирование.

PCI DSS — стандарт безопасности для обработки данных платёжных карт. Если ваш бот хранит или обрабатывает номера карт — вы обязаны соответствовать PCI DSS.

Решение: не храните данные карт вообще. Используйте токенизацию — платёжная система (ЮKassa, Stripe) обрабатывает карту на своей стороне и возвращает токен. Бот работает только с токеном.

ЮKassa и Stripe автоматически токенизируют данные карт — вам не нужно беспокоиться о PCI DSS.

Каждый webhook от платёжной системы содержит подпись. Это защита от мошенников, которые могут отправить поддельный webhook с «успешной оплатой».

 1import hmac
 2import hashlib
 3
 4def verify_webhook_signature(body: bytes, signature: str, secret: str) -> bool:
 5    """Проверка подписи webhook от ЮKassa"""
 6    expected = hmac.new(
 7        secret.encode(),
 8        body,
 9        hashlib.sha256
10    ).hexdigest()
11    return hmac.compare_digest(expected, signature)

Правило: никогда не выдавайте товар без проверки подписи webhook'а. Даже если webhook пришёл с правильного IP-адреса.

Распроблема: пользователь нажимает «Оплатить» дважды, и списывается двойная сумма.

Решение — идемпотентность:

 1import uuid
 2
 3# Генерируем уникальный ключ для каждой операции
 4idempotency_key = str(uuid.uuid4())
 5
 6payment = Payment.create({...}, idempotency_key=idempotency_key)

ЮKassa использует idempotency_key для предотвращения дублирования. Если два запроса с одинаковым ключом — второй будет проигнорирован.

Дополнительно: храните статус заказа в базе данных. Если заказ уже «оплачен» — не создавайте новый платёж.

Схема взаимодействия: 1. Пользователь нажимает «Оплатить» в боте 2. Bot → Payment Service → создаёт платёж в ЮKassa 3. ЮKassa возвращает ссылку на оплату 4. Пользователь оплачивает на странице ЮKassa 5. ЮKassa → Webhook Server → обновляет статус в БД 6. Payment Service → выдаёт товар пользователю 7. Notification Service → уведомляет менеджера

В платёжной системе ошибки неизбежны. Важно обрабатывать их gracefully:

 1import asyncio
 2from yookassa import Payment
 3from yookassa.domain.exceptions import ApiError
 4
 5async def safe_create_payment(amount: float, user_id: int) -> dict:
 6    """Создание платежа с обработкой ошибок"""
 7    try:
 8        payment = create_payment(amount, "Заказ", user_id)
 9        return {"status": "ok", "url": payment.confirmation.confirmation_url}
10    
11    except ApiError as e:
12        if e.status_code == 429:
13            # Rate limit — повторить через 5 секунд
14            await asyncio.sleep(5)
15            return await safe_create_payment(amount, user_id)
16        elif e.status_code >= 500:
17            # Ошибка сервера ЮKassa — уведомить админа
18            await notify_admin(f"ЮKassa error: {e}")
19            return {"status": "error", "message": "Платёжная система временно недоступна"}
20        else:
21            return {"status": "error", "message": str(e)}
22    
23    except asyncio.TimeoutError:
24        return {"status": "error", "message": "Превышено время ожидания"}
25    
26    except Exception as e:
27        await notify_admin(f"Unexpected payment error: {e}")
28        return {"status": "error", "message": "Произошла ошибка. Попробуйте позже."}

Типичные ошибки и их обработка:

Задача: Мастер йоги принимала оплату через переводы на карту. Клиенты: писали в личку → ждали ответа → копировали реквизиты → переводили → присылали скриншот → ждали подтверждения → получали доступ. 7 шагов. Конверсия: 8%.

Решение: Интеграция ЮKassa в Telegram-бота. Клиент: выбирает курс → нажимает «Оплатить» → вводит карту → получает доступ. 3 шага.

Результаты за 5 месяцев: • Конверсия выросла с 8% до 35% — в 4,4 раза • Доход вырос на 380% — с 150 000 ₽ до 720 000 ₽/мес • Предоплаты выросли с 20% до 95% • Экономия: 5 часов/день на обработке платежей • ROI: 450%

Стоимость интеграции: 25 000 ₽ (в составе проекта за 80 000 ₽).

Подробнее о проекте →

Задача: Продавец электроники на Avito (150+ объявлений) тратил 8 часов в день на обработку заказов. Ручные переводы, проверка оплат, отправка трек-номеров. Терял 30% клиентов из-за медленных ответов.

Решение: Комплексный Telegram-бот с автоматизацией платежей: клиент выбирает товар → оплата через СБП/ЮKassa → автоматическое создание заказа → отправка трек-номера.

Результаты за 3 месяца: • Оборот вырос на 280% — с 450 000 ₽ до 1 710 000 ₽/мес • Автоматизация платежей: 100% • Конверсия выросла на 45% • Экономия времени: 6 часов/день • ROI: 520%

Подробнее о проекте →

Задача: Салон красоты с 3 мастерами терял 30% записавшихся клиентов — не приходили без предупреждения. Предоплаты принимались только наличными.

Решение: Telegram-бот с записью и предоплатой через СБП. Клиент выбирает услугу, мастера, дату → оплачивает предоплату 50% → получает подтверждение.

Результаты за 3 месяца: • Предоплаты выросли в 3 раза — с 20% до 60% • Пропуски снизились на 85% — с 30% до 4,5% • Доход вырос на 40% — с 180 000 ₽ до 252 000 ₽/мес • ROI: 300%

Подробнее о проекте →

Ошибка 1: Нет проверки подписи webhook. Мошенники подделывают webhook с «успешной оплатой» и получают товар бесплатно. Всегда проверяйте подпись.

Ошибка 2: Выдача товара до подтверждения оплаты. Статус «pending» ≠ «succeeded». Проверяйте payment.status === 'succeeded'.

Ошибка 3: Хранение данных карт. Нарушение PCI DSS. Используйте токенизацию — данные карт обрабатывает только платёжная система.

Ошибка 4: Нет обработки ошибок. Карта отклонена, недостаточно средств, истёк срок — бот должен обработать все сценарии и предложить альтернативу.

Ошибка 5: Нет чеков. По 54-ФЗ нужно выдавать чеки. ЮKassa делает это автоматически, но если используете другой провайдер — настройте фискализацию отдельно.

Ошибка 6: Нет логирования. Без логов невозможно отследить проблемный платёж. Логируйте каждый шаг: создание платежа, webhook, выдачу товара.

Ошибка 7: Нет таймаута на оплату. Если клиент не оплатил в течение 30 минут — платёж должен автоматически отменяться. Иначе «зависшие» платежи забивают статистику.

Ежемесячные расходы: • Хостинг: 300–2 000 ₽/мес • Комиссия платёжной системы: 2–5% от оборота • ЮKassa (фискализация): включена в комиссию

Узнайте точную стоимость: калькулятор стоимости Telegram-бота. Если нужна интеграция с внешними сервисами — посмотрите руководство по разработке API.