StarsPaymee
Открыть бота
Бизнес

Подключение оплаты Stars к боту Telegram: пошагово для разработчиков (2026)

sendInvoice, валюта XTR и логика refund простым языком — как подключить оплату Stars к боту Telegram.

Краткий ответ

Чтобы подключить оплату Stars к боту Telegram, используется метод Bot API sendInvoice с currency: "XTR" (код валюты Stars). Когда пользователь оплачивает счёт, бот получает обновление successful_payment; если услуга не оказана, оплату можно вернуть через метод refundStarPayment. Это самый простой способ монетизации, работающий полностью внутри Telegram без внешнего платёжного провайдера.

Что такое валюта XTR и sendInvoice?

В Telegram Bot API Stars работают через специальный код валюты — XTR. В отличие от обычных платёжных провайдеров, для Stars поле provider_token оставляется пустым — это означает, что подключение к внешнему банку или платёжной системе не требуется. Весь процесс проходит на серверах Telegram.

Пошагово: подключение оплаты Stars к боту

  1. Создайте ботаСоздайте нового бота через @BotFather или используйте существующего.
  2. Вызовите sendInvoiceОтправьте счёт с currency: "XTR", ценой товара (в Stars) и описанием.
  3. Обработайте pre_checkout_queryTelegram отправляет запрос подтверждения перед оплатой — ваш бот должен быстро его подтвердить.
  4. Отслеживайте successful_paymentПосле успешной оплаты бот активирует услугу или доставляет товар.

Нужен тест Stars для вашего проекта? В боте — в сумах за 10 секунд.

@StarsPaymee_bot

Как работает логика возврата (refund)?

Основы refund
  • refundStarPayment: используется для полного возврата оплаты при технической ошибке или неоказанной услуге.
  • telegram_payment_charge_id: для возврата требуется идентификатор исходного платежа.
  • Доверие пользователей: чёткая политика возврата повышает доверие к вашему боту.

Общий механизм работы Stars — в статье «Как работают Stars».

Практические советы

  • Указывайте цену чётко: пользователь должен точно знать, сколько Stars будет списано перед оплатой.
  • Отвечайте быстро: на pre_checkout_query нужно ответить в течение 10 секунд, иначе оплата отменяется.
  • Логируйте ошибки: отслеживание неудачных платежей важно для поддержки.

Как выглядит оплата Stars в Mini App — в статье «Оплата Stars в играх и Mini App», а доход через партнёрскую программу — в «Партнёрская программа Telegram».

Источники

Часто задаваемые вопросы

Какой код валюты используется для оплаты Stars в боте?
XTR — специальный код валюты для Stars в Telegram Bot API.
Нужен ли provider_token для оплаты Stars?
Нет, для Stars поле provider_token оставляется пустым — внешний платёжный провайдер не требуется.
За какое время нужно ответить на pre_checkout_query?
В течение 10 секунд, иначе оплата автоматически отменяется.
Можно ли вернуть оплату, если услуга не оказана?
Да, через метод refundStarPayment с использованием telegram_payment_charge_id можно вернуть оплату полностью.
Нужна ли специальная лицензия для добавления оплаты Stars?
Нет, это открытая стандартная функция Telegram Bot API — доступна любому разработчику.

Хотите протестировать свой проект?

Купите Stars для теста в сумах, в боте за 10 секунд.

Открыть бот