Come accettare pagamenti in Telegram Stars nel tuo bot (Guida 2026)

Cosa sono le Telegram Stars

Le Telegram Stars sono la valuta interna di Telegram. Gli utenti comprano le Stars in pacchetti e le spendono per cose digitali dentro Telegram: contenuti a pagamento di bot e mini app, regali, reazioni e post a pagamento nei canali, e così via. Per chi possiede un bot, le Stars sono il modo ufficiale per far pagare beni e servizi digitali. La Bot API di Telegram tratta le Stars come una valuta con il codice XTR, e i suoi termini richiedono che tutti i pagamenti per beni e servizi digitali dentro le app di Telegram passino dalle Stars, il che mantiene i bot in regola con le norme di App Store e Google Play.

Dove un utente compra le Stars influisce su quanto paga. Nelle app iOS e Android l'acquisto passa da Apple o Google e, a settembre 2026, lì una Star costa circa due centesimi di dollaro. Comprare nelle app web e desktop di Telegram o su Fragment, il marketplace di Telegram, è sensibilmente più economico perché la commissione dell'app store non è inclusa. I prezzi variano per regione, Telegram può aggiungere le tasse locali e i pacchetti cambiano, quindi considera queste cifre indicative e controlla il prezzo attuale nella tua app.

Dal tuo lato della transazione, i termini di Telegram per gli sviluppatori di bot chiariscono quanto vale una Star per te: puoi spendere le Stars in Telegram Ads al tasso di 0,02 USD di credito pubblicitario per Star, oppure richiedere una ricompensa, che Telegram elabora tramite Fragment e paga in Toncoin all'equivalente di 0,013 USD per Star. Gli stessi termini dicono che le Stars nel tuo saldo possono impiegare fino a 21 giorni dalla ricezione per diventare disponibili. Il divario tra ciò che paga l'utente e ciò che ricevi tu è il costo dell'intero sistema: commissione dell'app store, quota di Telegram e pagamento in cripto. Resta comunque più economico e molto meno laborioso della maggior parte dei processori di carte a piccoli volumi, ma pianifica i tuoi prezzi con la cifra 0,013, non con il prezzo al dettaglio.

Com'è un pagamento in Stars per l'utente

È questa la parte che fa funzionare le Stars per i piccoli venditori. Non c'è nessuna pagina di checkout e nessun inserimento di carta. Tutto il flusso avviene nella chat:

1. L'utente invia un comando o tocca un pulsante, e il tuo bot risponde con una breve anteprima: cosa sta per ricevere e il prezzo in Stars.
2. Tocca Acquista. Telegram mostra un messaggio di fattura con una scheda di conferma nativa. Se il suo saldo Stars non basta, Telegram propone di ricaricarlo sul momento.
3. Un tocco per confermare. Telegram chiede al tuo bot di approvare l'acquisto (è il passaggio di pre-checkout, e il bot ha 10 secondi per rispondere), poi addebita le Stars.
4. Il tuo bot riceve una notifica di pagamento riuscito e consegna il contenuto, oppure avvisa l'acquirente che lo contatterai.

Per chi compra è come acquistare un pacchetto di sticker o un regalo Premium. Questa assenza di attrito è il motivo per cui barattoli delle mance e piccoli sblocchi convertono molto meglio in Stars che tramite un link esterno a un modulo carta.

Cosa puoi vendere con le Stars

Qualsiasi cosa digitale che un bot possa consegnare o che tu possa erogare online. Gli schemi più frequenti:

• Comandi a pagamento e contenuti bloccati. Un comando che risponde per intero solo dopo il pagamento: una checklist in PDF, un pacchetto di template, un link di invito privato, una registrazione, una serie di immagini, un codice sconto. L'utente vede un'anteprima, paga, e riceve la risposta completa.
• Donazioni e mance. Un comando /donate con alcuni importi predefiniti e un'opzione per l'importo personalizzato. Ideale per creator, progetti open source, amministratori di community e podcaster che vogliono soprattutto dire "sostieni quello che faccio".
• Prodotti digitali. E-book, preset, pacchetti di lezioni, schede di esercizi, mini corsi, sfondi, audio. Se li vendi già altrove, una versione in Stars dentro Telegram è un secondo scaffale con quasi zero configurazione.
• Servizi erogati online. Uno slot di consulenza, una revisione del portfolio, un piano alimentare personalizzato. Il bot incassa il pagamento e tu consegni a mano.
• Abbonamenti. Telegram supporta abbonamenti ricorrenti in Stars per bot e canali, addebitati periodicamente. TeleMinute al momento vende sblocchi una tantum e donazioni, non abbonamenti ricorrenti, quindi se ti servono iscrizioni a rinnovo automatico avrai bisogno di codice personalizzato o di un altro strumento per quella parte.

Se gestisci un corso online, la nostra guida ai bot Telegram per i corsi online spiega come strutturare lezioni e gruppi di studenti; le Stars sono il modo naturale per farli pagare. Per una panoramica più ampia dei modelli di guadagno con i bot, leggi come guadagnare con i bot Telegram.

Le regole: solo digitale, e i rimborsi sono a carico tuo

Due regole contano più di tutte le altre. Primo, le Stars sono solo per beni e servizi digitali. I termini delle Stars di Telegram le descrivono come un modo per acquistare beni e servizi digitali da bot e mini app, e i termini per gli sviluppatori richiedono che le vendite digitali usino esclusivamente le Stars. Una maglietta, una consegna di cibo o un servizio di persona non sono prodotti da Stars. Per i beni fisici colleghi comunque un normale fornitore di pagamento tramite la Bot API o rimandi alla tua pagina di checkout, e le funzioni a pagamento di TeleMinute lì non ti saranno d'aiuto.

Secondo, i rimborsi sono responsabilità del venditore. Telegram dichiara che le vendite di Stars agli utenti sono definitive, ma da uno sviluppatore ci si aspetta che rimborsi un acquirente che non ha ricevuto quanto promesso entro i tempi concordati, e Telegram non fa da mediatore nelle controversie. La Bot API ha un metodo di rimborso dedicato ai pagamenti in Stars, quindi un rimborso è un'unica azione e non un ticket di assistenza, ma assicurati che le tue anteprime siano oneste su cosa riceve l'acquirente e quando.

Qualche punto minore che vale la pena conoscere: le Stars nel saldo di un bot non sono di tua proprietà in senso legale, sono un saldo che puoi convertire; se l'account del proprietario del bot viene eliminato, il saldo va perso; e Fragment potrebbe non riuscire a pagare le ricompense agli utenti di alcuni paesi. Leggi i termini attuali una volta prima di costruirci sopra un'attività.

Consigli sui prezzi in Stars

• Usa numeri tondi in Stars. 25, 50, 100, 250, 500. Gli utenti ragionano in pacchetti, e un prezzo come 73 Stars sembra una conversione da un'altra valuta.
• Fai i conti con 0,013, non con 0,02. Un prodotto da 100 Stars ti rende circa 1,30 USD in valore di ricompensa, non 2 USD. Prezza il tuo lavoro di conseguenza.
• Ricorda dove compra il tuo pubblico. Un pubblico soprattutto mobile paga il prezzo dell'app store; un pubblico desktop può comprare a meno sul web o su Fragment. Dire agli utenti che le Stars costano meno sul web è corretto e spesso apprezzato.
• Rispetta il potere d'acquisto regionale. Dietro le quinte le Stars sono prezzate in dollari. 500 Stars sono una mancia facile in un mercato e un acquisto serio in un altro. Se il tuo pubblico è globale, mantieni una fascia bassa (25 o 50 Stars) accanto al prezzo principale.
• Offri una fascia mancia anche se vendi prodotti. Alcuni utenti non compreranno un prodotto ma manderanno volentieri 50 Stars dopo una risposta utile.
• Pianifica il periodo di attesa. Con fino a 21 giorni prima che le Stars diventino disponibili, i soldi non sono contanti della stessa settimana. Trattali come un pagamento mensile.

Come accettare Stars con TeleMinute, senza codice

TeleMinute è un costruttore di bot Telegram no-code: comandi, risposte a parole chiave, pulsanti, moduli lead, broadcast, statistiche, un report giornaliero e pubblicazione automatica da RSS, sul web e nelle app native iOS e Android, con l'interfaccia in 10 lingue. I pagamenti in Stars sono integrati nell'editor e sono disponibili con il piano Premium ($3.99 a settimana, $9.99 al mese o $49.99 a vita, con sconti regionali applicati automaticamente). Ecco tutta la configurazione.

1. Collega il tuo bot. Crea un account TeleMinute e incolla il token di BotFather (la nostra guida a BotFather mostra come), oppure inizia con un bot demo di 15 minuti dal pool di TeleMinute e aggiungi il tuo token più tardi. I pagamenti richiedono un bot di tua proprietà, quindi aggiungi il token prima di andare online.
2. Crea come comando ciò che vendi. Nell'editor del bot, aggiungi un comando come /checklist e metti il contenuto da consegnare nella sua risposta: testo, fino a 4 immagini e pulsanti che possono aprire un URL, ad esempio un download o un link di invito privato.
3. Attiva Contenuto a pagamento. Sullo stesso comando, attiva Contenuto a pagamento. Imposta il Prezzo (Stars), un numero intero qualsiasi da 1 a 100.000. Scrivi un Testo di anteprima, cioè l'anticipazione che gli utenti vedono prima di pagare; se lo lasci vuoto, TeleMinute mostra una nota predefinita di contenuto bloccato. Scegli la Consegna: Automatica invia il contenuto del comando subito dopo il pagamento e l'acquirente conserva l'accesso, quindi inviando di nuovo il comando riceve il contenuto senza un secondo addebito; Manuale significa che contatti tu l'acquirente e consegni personalmente, adatto a consulenze e lavori su misura.
4. Aggiungi donazioni e un negozio nella scheda Pagamenti. Sotto Donazioni, abilita la funzione, mantieni o rinomina il comando di donazione (/donate per impostazione predefinita), inserisci fino a tre importi predefiniti come 50, 100 e 250 Stars, decidi se consentire un importo personalizzato e scrivi un messaggio di ringraziamento. Sotto Negozio, abilita un comando negozio (/store per impostazione predefinita) che elenca tutti i comandi a pagamento in un unico menu, così gli utenti possono sfogliare quello che vendi.
5. Salva e prova con il tuo account. Apri il tuo bot su Telegram, invia il comando a pagamento e controlla l'anteprima e il pulsante Acquista. Paga una volta con le tue Stars per vedere la fattura e la consegna esattamente come le vedrebbe un cliente. Dopo puoi rimborsarti.
6. Annuncialo. Cita il comando a pagamento nel tuo messaggio /start, aggiungi un pulsante che lo esegue e usa un broadcast per avvisare gli utenti esistenti. Le risposte a parole chiave possono indirizzare chi scrive "prezzo" o "compra" al comando negozio.
7. Tieni traccia delle vendite. La pagina Vendite di ogni bot mostra il totale incassato, il totale rimborsato e il numero di vendite, più una riga per ogni pagamento con acquirente, articolo, importo, data e stato. Gli acquisti con consegna manuale sono segnalati come "Consegna in sospeso" finché non li gestisci. Ogni riga ha Rispondi, che scrive all'acquirente tramite il tuo bot, e Rimborsa, che restituisce le Stars all'acquirente. Il report giornaliero può includere le vendite in Stars, così ricevi un riepilogo su Telegram ogni mattina.
8. Preleva. Le Stars vanno direttamente nel saldo Telegram del tuo bot, non a TeleMinute; TeleMinute non trattiene alcuna quota sulle tue vendite. Quando le Stars diventano disponibili, usale per Telegram Ads o richiedi una ricompensa tramite Fragment, seguendo i termini attuali di Telegram.

Dietro le quinte TeleMinute invia la fattura in XTR, risponde alla richiesta di pre-checkout, verifica l'importo, registra il pagamento in modo che una notifica duplicata non possa consegnare due volte, e ricorda chi ha già sbloccato cosa. Tu non tocchi nulla di tutto questo.

Domande frequenti

Quanto vale una Telegram Star?

Dipende da quale lato del pagamento ti trovi. Gli utenti comprano le Stars in pacchetti e, a settembre 2026, una Star costa circa due centesimi di dollaro nelle app iOS e Android, meno se acquistata tramite Telegram sul web o su Fragment, perché non c'è la commissione dell'app store. Dal lato del proprietario del bot, i termini di Telegram per gli sviluppatori di bot fissano la ricompensa all'equivalente di 0,013 USD per Star, oppure 0,02 USD di credito pubblicitario se spendi le Stars in Telegram Ads. I prezzi variano per regione e cambiano nel tempo, quindi controlla i termini attuali di Telegram.

Posso vendere prodotti fisici con le Telegram Stars?

No. I termini di Telegram riservano le Stars a beni e servizi digitali: contenuti, accessi, download, consulenze, abbonamenti, vantaggi dentro il bot. I beni fisici e i servizi erogati offline vanno venduti tramite un normale fornitore di pagamento collegato alla Bot API di Telegram, oppure tramite un link al tuo checkout. I comandi a pagamento, le donazioni e il negozio di TeleMinute funzionano solo con le Stars e quindi solo per il digitale.

Come prelevo le Stars che guadagna il mio bot?

Le Stars pagate al tuo bot finiscono nel saldo Stars del bot stesso su Telegram, non in TeleMinute. I termini per gli sviluppatori di Telegram dicono che le Stars possono impiegare fino a 21 giorni dalla ricezione per diventare disponibili; dopodiché puoi spenderle in Telegram Ads oppure richiedere una ricompensa tramite Fragment, che paga in Toncoin all'equivalente di 0,013 USD per Star. Fragment potrebbe non essere disponibile in alcuni paesi e potrebbe esserci un importo minimo, quindi controlla i termini attuali di Telegram prima di contarci.

Devo scrivere codice per accettare Stars con TeleMinute?

No. Nell'editor di TeleMinute attivi Contenuto a pagamento su qualsiasi comando, inserisci un prezzo in Stars, aggiungi se vuoi un testo di anteprima e scegli la consegna automatica o manuale. La scheda Pagamenti aggiunge un comando di donazione con importi predefiniti e un comando negozio che elenca tutti i comandi a pagamento. Fatture, conferma pre-checkout, consegna, una pagina Vendite con rimborsi e risposte agli acquirenti sono gestiti per te. Le funzioni a pagamento richiedono un piano Premium.