TSocial TSocial
Open in Telegram
Better in TelegramOpen in Telegram
TSocial planet logoTelesocial

Telesocial › Cheat sheets

Stars Payment Flow at a Glance

Cheat sheets · 2026-11-06 · 18+ readers

A Telegram Stars star icon Stars sale is a short conversation between your bot and Telegram. Here it is as a timeline.

The timeline

StepWho actsWhat happens
1BotSends an invoice with currency XTR
2BuyerPresses Pay
3 TelegramSends pre_checkout_query
4BotAnswers ok within about ten seconds
5 TelegramSends a message with successful_payment
6BotRecords the charge id and delivers
7Bot (later)Calls refundStarPayment if needed

Fields worth remembering

  • Invoice: title, description, payload, currency, prices with one item.
  • Payment record: total_amount, invoice_payload, telegram_payment_charge_id.
  • Refund: user_id and the charge id.

Safety rules

  • Deliver only after successful_payment.
  • Deliver once, even if the update repeats.
  • Check amount and currency against your order.
  • Offer a support contact and a clear refund policy.

Frequently asked questions

Do I need a provider token?

Not for Stars.

Can an invoice list several items?

Stars invoices carry one price item. Bundle products instead.

Where do I see totals?

getStarTransactions lists transactions.

More cheat sheets

Stars Payment Flow at a Glance | Telesocial