Guida all'Impostazione, Regole dei Stars e Commissioni Reali
Telegram richiede la propria valuta Stars (XTR) per beni e servizi digitali venduti all'interno di bot e Mini App.
I gateway di pagamento in criptovaluta intervengono per tutto ciò che Stars non copre: servizi nel mondo reale, beni fisici, saldi della piattaforma, depositi e pagamenti B2B. Questa guida illustra ciò che è effettivamente consentito, due modi pratici per impostare l'accettazione delle criptovalute, quali sono i costi e una soluzione alternativa per l'unica cosa che le criptovalute non possono ancora fare: abbonamenti ricorrenti.
Punti Chiave
Ci sono due modi pratici per accettare criptovalute da un Mini App o bot di Telegram: custodiale automatizzato e non custodiale automatizzato (smart contract).
Nessuna blockchain attualmente supporta abbonamenti ricorrenti reali senza seri compromessi sulla sicurezza: la soluzione pratica è un saldo ricaricabile all'interno dell'app.
I pagamenti con carta all'interno del WebView di un Mini App spesso hanno difficoltà con 3D Secure e controlli antifrode: un motivo pratico per cui le criptovalute tendono a funzionare più agevolmente in questo ambiente specifico.
Le false Mini App create per svuotare i portafogli connessi sono una minaccia attiva e in crescita nel 2026.
Bots vs. Mini App
La maggior parte dei contenuti "come accettare criptovalute su Telegram" riguarda in realtà i bot: invii un link di pagamento o una fattura come messaggio di chat, l'utente lo tocca e si apre un browser (o il checkout integrato).
Un Mini App è diverso: è un'applicazione web completa che si apre direttamente all'interno di Telegram come un WebView, con la propria interfaccia, navigazione e — se lo desideri — il proprio flusso di pagamento integrato nell'interfaccia utente piuttosto che aggiunto come un link.
Crypto Wallet — raggiungibile dall'icona di allegato in qualsiasi chat di Telegram — è un buon esempio di come ci si sente in pratica: saldi, flussi di invio/ricezione, la propria navigazione, il tutto senza lasciare la chat.
Se stai costruendo un servizio in abbonamento, un marketplace o una piattaforma di iGaming, stai quasi certamente costruendo una Mini App, non un semplice bot. I passaggi di configurazione qui sotto si applicano a entrambi, ma l'esperienza di checkout è notevolmente migliore all'interno di una Mini App perché la pagina di pagamento può vivere all'interno della tua interfaccia invece di reindirizzare l'utente altrove.
Telegram Stars vs. gateway crypto
La documentazione sui pagamenti dei bot di Telegram richiede che i beni e i servizi digitali venduti all'interno di un bot o di una Mini App utilizzino Telegram Stars (codice valuta XTR) — non carte, non crypto. Questo copre cose come sbloccare contenuti premium, acquistare valuta in-app per un gioco o pagare per un abbonamento digitale consumato interamente all'interno di Telegram.
Volet.com · Controllo pagamenti Telegram
Stelle, o un gateway crypto?
Scegli cosa stai vendendo. La risposta segue i Termini di Servizio per Sviluppatori Bot di Telegram, non consigli generali.
Dove i gateway di pagamento in criptovaluta sono lo strumento giusto e legittimo:
Servizi forniti al di fuori di Telegram — una connessione VPN, hosting, un prodotto SaaS, consulenza, qualsiasi cosa che l'utente consuma al di fuori della piattaforma anche se paga per essa all'interno di un bot di Telegram.
Prodotti fisici — qualsiasi cosa spedita o consegnata di persona.
Saldi e depositi della piattaforma — ricaricare un portafoglio all'interno della propria app (questa è anche la soluzione pratica per il problema dell'abbonamento qui sotto).
Pagamenti B2B e transfrontalieri — pagamenti per affiliazione, regolamenti di marketplace tra aziende, che rientrano completamente al di fuori della definizione di Telegram di "beni digitali venduti in-app".
Pagamenti con carta all'interno del WebView di una Mini App
C'è una ragione tecnica per cui le criptovalute tendono a sembrare più fluide rispetto alle carte specificamente all'interno dell'ambiente di Telegram. Le Mini App funzionano all'interno di un WebView — un browser incorporato, non uno completo — e i processori di carte spesso hanno difficoltà con quell'ambiente: i controlli anti-frode possono fallire, e le finestre di conferma 3D Secure spesso non si aprono correttamente o non restituiscono il controllo alla pagina, lasciando il cliente bloccato a metà pagamento senza un chiaro passo successivo.
Le criptovalute aggirano questo problema, perché non c'è rete di carte e nessun passaggio 3D Secure nel loop da interrompere all'interno di un WebView in primo luogo. Analizziamo più nel dettaglio.
Due modi per accettare criptovalute in Telegram
Naturalmente sei sempre libero di condividere un indirizzo di portafoglio a mano e controllare i pagamenti tu stesso — ma non scala oltre occasionali fatture una tantum. Per qualsiasi cosa tu stia costruendo per durare, stai davvero scegliendo tra due modelli automatizzati.
Accettazione automatizzata in custodia
Questo è ciò che la maggior parte delle aziende desidera realmente. Integra un gateway di pagamento — tramite API o Checkout Ospitato — e gestisce l'intero flusso:
Il gateway genera automaticamente una fattura e i dettagli di pagamento per ogni acquisto, estraendo un indirizzo da un pool e calcolando l'importo dovuto.
Il cliente invia il pagamento; il gateway lo abbina automaticamente alla fattura.
Il gateway notifica il tuo backend tramite webhook una volta confermato il pagamento, così puoi fornire l'accesso automaticamente.
I fondi vengono accreditati sul tuo saldo commerciale — sia nella stessa criptovaluta con cui il cliente ha pagato, sia automaticamente convertiti in una stablecoin o in valuta fiat, il che è utile se i tuoi prezzi sono impostati in USD e non vuoi esposizione alla volatilità delle criptovalute.
All'interno di Telegram, questo appare diverso a seconda di come integri:
Via API, costruisci tu stesso l'interfaccia nei messaggi del tuo bot o all'interno degli schermi della tua Mini App.
Via Checkout Ospitato, la Mini App apre un webview con una pagina di pagamento pronta — nessuno sviluppo backend richiesto da parte tua, e funziona allo stesso modo che tu stia costruendo un bot o una Mini App completa.
Questo è l'aspetto della pagina di Checkout Ospitato di Volet.com
Accettazione automatizzata non custodiale (smart contract)
Qui, i fondi non passano mai attraverso il gateway. Il cliente collega il proprio wallet direttamente al tuo checkout e paga tramite uno smart contract direttamente al tuo wallet. Il gateway addebita una piccola commissione di elaborazione ma non custodisce mai i fondi; il regolamento avviene interamente all'interno della transazione stessa.
Il flusso utente effettivo appare così:
Il cliente tocca "Collega Wallet."
Viene reindirizzato all'app del wallet per approvare la connessione — su mobile, si apre l'app del wallet stesso; su desktop, un'estensione del browser o scansione QR.
Viene riportato al tuo checkout.
Conferma i dettagli della transazione.
Viene reindirizzato di nuovo al proprio wallet per firmare il pagamento.
Viene riportato a una pagina di conferma, che attende che la transazione si finalizzi on-chain prima di contrassegnare l'ordine come completato.
Un ulteriore dettaglio tecnico: la notifica API non fa parte dello smart contract. Il trasferimento sulla blockchain stesso è l'unica cosa che avviene on-chain — tutto il resto (aggiornamento dello stato dell'ordine, concessione di accesso, invio di una conferma) è logica di backend separata da parte tua, attivata dal webhook una volta che il gateway rileva la transazione.
Questo esatto flusso — connetti il portafoglio, firma una transazione — è anche ciò che i truffatori imitano. Cloni fraudolenti di popolari Mini App tap-to-earn, inclusi Notcoin e imitazioni di Hamster Kombat, hanno spinto gli utenti a connettere i propri portafogli solo per un contratto intelligente malevolo che drena i fondi istantaneamente e in modo irreversibile.
Non rende Connect Wallet insicuro per design, ma la legittimità deve essere visibilmente ovvia: un dominio di pagamento coerente e verificabile, un'approvazione di spesa fissa e dettagliata piuttosto che una aperta, e una regola ferrea che un vero checkout non chiede mai una frase seed o un deposito anticipato — solo una firma dall'app portafoglio del cliente.
TON (The Open Network), recentemente rinominato al suo nome originale Gram, è l'unica scelta per TON Connect nel flusso non custodiale sopra. Questo non è un consiglio — è una regola. I termini di servizio per sviluppatori di bot di Telegram richiedono che qualsiasi Mini App che tocchi la funzionalità del portafoglio si connetta esclusivamente tramite TON Connect.
Perché Telegram impone questo: TON è la blockchain di Telegram, e l'azienda ha una partecipazione diretta e crescente nel suo successo. Nel maggio 2026, Telegram ha preso il controllo diretto dell'infrastruttura di TON: l'azienda ha messo in stake 2,2 milioni di token per diventare il principale validatore della rete, sostituendo la TON Foundation come operatore principale.
L'accettazione custodiale tramite l'API di Volet.com o il Checkout Ospitato non incontra affatto questo problema — non c'è alcun passaggio di connessione al portafoglio che avviene all'interno della Mini App stessa, quindi quali asset puoi accettare non è limitato allo stesso modo.
Nessuna blockchain oggi supporta la fatturazione ricorrente automatica come fa una rete di carte — le approssimazioni più vicine richiedono o di dare a un contratto intelligente il permesso permanente di prelevare fondi indefinitamente (un compromesso di sicurezza significativo che la maggior parte delle aziende non dovrebbe accettare) o di costruire qualcosa di così fragile che non vale la pena di essere spedito.
La soluzione pratica è un saldo ricaricabile invece di un abbonamento:
L'utente ricarica un saldo all'interno della tua Mini App utilizzando criptovalute — attraverso lo stesso flusso custodiale o non custodiale descritto sopra.
La tua app detrae il costo dell'abbonamento da quel saldo secondo un programma che controlli.
Puoi persino mantenere e visualizzare quel saldo in termini fiat (in modo che l'utente veda "$9.99 rimanenti" invece di un importo di criptovaluta fluttuante) mentre accetti comunque la ricarica stessa in criptovaluta.
Richiede un po' più di lavoro di sviluppo all'interno della tua Mini App, ma è la versione che effettivamente viene spedita oggi senza chiedere agli utenti di concedere permessi permanenti a un contratto intelligente.
Offerta di Volet.com per i pagamenti in Telegram
L'acquisizione di criptovalute tramite Volet.com non richiede un fatturato minimo per iniziare, senza costi di configurazione per l'API o il Checkout Ospitato, e senza costi di abbonamento mensile.
Modello
Commissione del commerciante
Commissione di prelievo
Custodiale (API o Checkout Ospitato)
A partire da 0.25%
A partire da $0.5 fisso (di più se si converte — vedi sotto)
Non custodiale (contratto intelligente)
0.25%
Nessuna — i fondi atterrano direttamente nel tuo portafoglio
La tariffa sopra è il livello base per accettare pagamenti senza conversione. La conversione opzionale al momento del regolamento è tariffata separatamente — e il caso più comune, stablecoin in USD, non costa nulla in più. Ecco cosa costa effettivamente la conversione al momento del regolamento:
Esempio: il saldo unico di $9.99 del servizio VPN ricaricato in USDT.
Custodiale (API o Checkout Ospitato):
Il cliente ti invia 9.99 USDT dal proprio portafoglio.
Ti viene accreditato $9.99 meno la commissione di acquisizione del 0.25% (circa $0.02), quindi circa $9.97 atterra nel tuo saldo aziendale di Volet.com.
Quel saldo si accumula con ogni ricarica del cliente, e quanto costa prelevarlo dipende da cosa fai dopo.
Opzione più economica: salta il fiat e preleva, ad esempio, $1,000 nel tuo stesso portafoglio cripto nello stesso asset — solo la commissione di rete fissa (circa $0.5–3.5 a seconda della rete), quindi manterresti circa $996.50–$999.50.
Se vuoi fiat, converti nel momento in cui accetti ogni pagamento (regolando in USD invece di mantenere USDT) piuttosto che convertire in seguito — quella conversione è gratuita, quindi prelevare il saldo risultante di $1,000 USD al tuo conto bancario costa solo la commissione di prelievo, a partire da 1% a seconda del metodo, lasciandoti con circa $990.
Convertire un saldo USDT già accumulato in USD dopo il fatto, all'interno del tuo account, costa 1% in aggiunta a quello — più la stessa commissione di prelievo — quindi finiresti con circa $980 invece.
Non custodiale (contratto intelligente):
Il cliente collega il proprio portafoglio e firma lo stesso pagamento di 9.99 USDT.
Il contratto intelligente instrada il pagamento direttamente nel tuo portafoglio, meno la stessa commissione di elaborazione del 0.25% — ricevi circa $9.97, già seduto nel tuo portafoglio.
Non c'è alcun passaggio di prelievo separato e nessuna commissione di prelievo, perché i fondi non sono mai stati con il gateway per cominciare.
Scala questo fino allo stesso $1,000 in pagamenti totali dei clienti utilizzati nell'esempio custodiale sopra, e il confronto è semplice: $997.50 atterra direttamente nel tuo portafoglio.
Volet.com aiuta a costruire i tuoi pagamenti globali
In fiat, cripto e stablecoin. Tramite API, checkout ospitato o plugin facili da installare. Accetta, invia e gestisci fondi — tutto dal codice.
No. Il Checkout Ospitato non richiede sviluppo backend: il Mini App apre una webview di pagamento pronta all'uso.
Ma è disponibile anche un'integrazione API completa se desideri avere maggiore controllo sull'esperienza di checkout.
Puoi iniziare come individuo.
L'acquisizione di criptovalute ha una barriera all'ingresso notevolmente più bassa rispetto ai tradizionali sistemi di pagamento oggi: non è necessaria un'entità legale separata, un conto bancario aziendale o un consulente legale dedicato per collegarlo, e uno sviluppatore solitario può impostare l'accettazione custodiale o non custodiale direttamente.
Sì, con l'accettazione custodiale, i pagamenti in criptovalute in arrivo possono essere automaticamente convertiti in USD o EUR al momento del regolamento, quindi il tuo saldo non si muove con i prezzi delle criptovalute anche se il tuo cliente ha pagato con un asset volatile.
I pagamenti non custodiali si regolano direttamente in base a ciò con cui il cliente ha pagato, poiché non c'è alcun passaggio intermedio di conversione in quel flusso.
Gli strumenti per automatizzare la contabilità delle criptovalute e la reportistica fiscale sono ancora molto meno maturi rispetto a ciò che esiste per i ricavi da carte o banche: un vero punto dolente se hai bisogno di libri puliti e pronti per la revisione.
Convertire i pagamenti in arrivo in una stablecoin o in fiat al momento del regolamento (disponibile con l'accettazione custodiale di Volet.com) rimuove la complessità aggiuntiva di monitorare i movimenti dei prezzi delle criptovalute oltre alle transazioni stesse.
