How to Gift Telegram Stars: Contact Gifting, Birthday Rewards, Mini App Credits & Profile Badges
Celebrate friends and support community creators. Discover how to purchase and gift Telegram Stars directly to your contacts—delivering virtual credits with celebratory animations that recipients can spend on mini app tools, gaming items, and exclusive channel content.
How Star Gifting Invoices Are Processed
A technical overview of the MTProto Layer 174 schema that powers peer-to-peer Star gifting.
// Query Available Gift Packages for a Peer
payments.getPaymentForm#37148dbb flags:#
invoice:InputInvoice
theme_params:flags.0?DataJSON = payments.PaymentForm;
// Input Invoice for Peer Gift Transaction
inputInvoiceStars#64645224 flags:#
purpose:InputStarsTransactionPurpose = InputInvoice;
inputStarsTransactionPurposeUser#1d451290
user_id:InputUser
stars:long = InputStarsTransactionPurpose;
// Successful Gift Delivery Payload in Chat
messageService#2b085862 flags:#
id:int
peer_id:Peer
date:int
action:MessageActionPaymentSentMe = Message;
When initiating a gift, Telegram constructs an inputInvoiceStars targeting the recipient's InputUser. Payments are settled via Apple In-App Purchase, Google Play Billing, or Toncoin on Fragment. Once validated, the ledger deposits the credits into the recipient's Star balance, emitting a service message with synchronized Lottie confetti animations.
Calculate gift packages, review recipient spending power, and simulate delivery animations.
How to Gift Telegram Stars to Any Contact
Send Stars to your friends and contacts in three simple steps.
•••) at the top right of the profile header.
Gifting Stars FAQ
Answers regarding expiration, transfers, and refunds.
