Сервис в разработкеBot API и документация будут дорабатываться: список методов, лимиты и поведение могут измениться.

Оплата Stars

Счета в XTR, pre-checkout, возвраты

Боты принимают оплату в Telegram Stars (XTR). Платёжный провайдер и provider_token не нужны.

Как проходит оплата

Бот выставляет счёт методом sendInvoice.
Пользователь нажимает "Оплатить", бот получает обновление pre_checkout_query.
Бот за 10 секунд отвечает answerPreCheckoutQuery с ok=true или ok=false.
При ok=true Stars списываются, бот получает сообщение с successful_payment.

Shell

curl "https://bot.catup.lol/bot$TOKEN/sendInvoice" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 123456789, "title": "Подписка", "description": "30 дней", "payload": "order-42", "currency": "XTR", "prices": [{"label": "Подписка", "amount": 50}]}'

Если бот не ответил за 10 секунд, оплата отменяется. Не копите очередь обновлений: очистить её можно методом dropPendingUpdates.

Возврат

refundStarPayment с user_id плательщика и telegram_payment_charge_id из successful_payment.

Подарки

getAvailableGifts, sendGift и giftPremiumSubscription оплачиваются со Stars-баланса бота. Передавайте ключ идемпотентности Idempotency-Key, чтобы повтор запроса не списал Stars дважды.