Use when implementing Telegram Stars (XTR) payments for digital goods, subscriptions, or tips. Also use when handling pre-checkout queries, processing successful_payment updates, or issuing Star refunds.
| Model | Source |
|---|
| inherit | pack: telegram |
| Item | Value |
|---|
| Currency | Telegram Stars (XTR) |
| Rate | ~$0.013 USD per Star (varies) |
| Min payment | 1 XTR |
| Refund window | 12 months |
| Provider token | Empty string "" (Stars-only) |
| Docs | core.telegram.org/bots/payments |
Full Reference
┏━ 🔧 telegram-stars ━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Telegram Stars (XTR) payments reference ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
| Item | Value |
|---|
| Currency | Telegram Stars (XTR) |
| Rate | ~$0.013 USD per Star (varies) |
| Min payment | 1 XTR |
| Refund window | 12 months |
| Provider token | Empty string "" (Stars-only) |
| Docs | core.telegram.org/bots/payments |
| File | Contents |
|---|
reference/payments.md | Stars payment flow — sendInvoice, pre-checkout, successful_payment, refunds |
reference/subscriptions.md | Star subscriptions — recurring billing, createInvoiceLink, renewal handling |
Usage: Read the reference file matching your current task. Each file has working code examples and inline gotchas.