Como aceitar pagamentos com Telegram Stars no seu bot (Guia 2026)

O que são as Telegram Stars

As Telegram Stars são a moeda interna do Telegram. Os usuários compram Stars em pacotes e as gastam em itens digitais dentro do Telegram: conteúdo pago de bots e mini apps, presentes, reações e publicações pagas em canais, e assim por diante. Para o dono de um bot, as Stars são a forma oficial de cobrar por bens e serviços digitais. A Bot API do Telegram trata as Stars como uma moeda com o código XTR, e seus termos exigem que todos os pagamentos por bens e serviços digitais dentro dos aplicativos do Telegram passem pelas Stars, o que mantém os bots alinhados com as regras da App Store e do Google Play.

Onde o usuário compra as Stars afeta quanto ele paga. Dentro dos aplicativos iOS e Android, a compra passa pela Apple ou pelo Google e, em setembro de 2026, uma Star custa ali cerca de dois centavos de dólar. Comprar nos aplicativos web e desktop do Telegram ou no Fragment, o marketplace do próprio Telegram, é visivelmente mais barato porque a comissão da loja de aplicativos não está incluída. Os preços variam por região, o Telegram pode adicionar impostos locais e os pacotes mudam, então trate esses números como aproximações e confira o preço atual no seu próprio aplicativo.

Do seu lado da transação, os termos do Telegram para desenvolvedores de bots deixam claro quanto uma Star vale para você: é possível gastar Stars no Telegram Ads a uma taxa de 0,02 USD em crédito de publicidade por Star, ou solicitar uma recompensa, que o Telegram processa pelo Fragment e paga em Toncoin ao equivalente a 0,013 USD por Star. Os mesmos termos dizem que as Stars no seu saldo podem levar até 21 dias após o recebimento para ficarem disponíveis. Essa diferença entre o que o usuário paga e o que você recebe é o custo de todo o sistema: comissão da loja de aplicativos, parte do Telegram e o pagamento em cripto. Ainda assim é mais barato e dá muito menos trabalho do que a maioria dos processadores de cartão em volumes pequenos, mas planeje seus preços com o número 0,013, não com o preço de varejo.

Como é um pagamento com Stars para o usuário

É essa a parte que faz as Stars funcionarem para pequenos vendedores. Não há página de checkout nem digitação de cartão. Todo o fluxo acontece no chat:

1. O usuário envia um comando ou toca em um botão, e seu bot responde com uma prévia curta: o que ele está prestes a receber e o preço em Stars.
2. Ele toca em Comprar. O Telegram mostra uma mensagem de fatura com uma tela de confirmação nativa. Se o saldo de Stars for insuficiente, o Telegram oferece a recarga na hora.
3. Um toque para confirmar. O Telegram pede ao seu bot que aprove a compra (é a etapa de pré-checkout, e o bot tem 10 segundos para responder) e então cobra as Stars.
4. Seu bot recebe o aviso de pagamento bem-sucedido e entrega o conteúdo, ou avisa o comprador de que você entrará em contato.

Para o comprador, é como comprar um pacote de figurinhas ou um presente Premium. Esse atrito baixo é o motivo de potes de gorjeta e pequenos desbloqueios converterem muito melhor em Stars do que por um link externo para um formulário de cartão.

O que você pode vender com Stars

Qualquer coisa digital que um bot possa entregar ou que você possa entregar online. Os padrões mais comuns:

• Comandos pagos e conteúdo bloqueado. Um comando que só responde por completo depois do pagamento: um checklist em PDF, um pacote de templates, um link de convite privado, uma gravação, um conjunto de imagens, um código de desconto. O usuário vê um teaser, paga, e a resposta completa é entregue.
• Doações e gorjetas. Um comando /donate com alguns valores predefinidos e uma opção de valor personalizado. Ideal para criadores, projetos de código aberto, administradores de comunidades e podcasters que querem principalmente dizer "apoie o que eu faço".
• Produtos digitais. E-books, presets, pacotes de aulas, planilhas de exercícios, minicursos, wallpapers, áudio. Se você já vende isso em outro lugar, uma versão em Stars dentro do Telegram é uma segunda prateleira com quase nenhuma configuração.
• Serviços entregues online. Um horário de consultoria, uma revisão de portfólio, um plano alimentar personalizado. O bot recebe o pagamento e você entrega manualmente.
• Assinaturas. O Telegram oferece assinaturas recorrentes em Stars para bots e canais, cobradas periodicamente. No momento, o TeleMinute vende desbloqueios únicos e doações, não assinaturas recorrentes, então, se você precisa de associações com renovação automática, vai precisar de código personalizado ou de outra ferramenta para essa parte.

Se você dá um curso online, nosso guia de bots do Telegram para cursos online mostra como estruturar aulas e turmas; as Stars são a forma natural de cobrar por elas. Para uma visão mais ampla dos modelos de receita com bots, veja como ganhar dinheiro com bots do Telegram.

As regras: só digital, e os reembolsos são por sua conta

Duas regras importam mais do que todas as outras. Primeira: as Stars são apenas para bens e serviços digitais. Os termos das Stars do Telegram as descrevem como uma forma de comprar bens e serviços digitais de bots e mini apps, e os termos para desenvolvedores exigem que as vendas digitais usem exclusivamente Stars. Uma camiseta, uma entrega de comida ou um serviço presencial não são produtos para Stars. Para produtos físicos, você continua conectando um provedor de pagamento comum pela Bot API ou usando um link para a sua própria página de checkout, e os recursos pagos do TeleMinute não vão ajudar nesse caso.

Segunda: os reembolsos são responsabilidade do vendedor. O Telegram afirma que as vendas de Stars aos usuários são finais, mas espera que o desenvolvedor reembolse um comprador que não recebeu o que foi anunciado dentro do prazo combinado, e o Telegram não faz mediação de disputas. A Bot API tem um método de reembolso dedicado para pagamentos em Stars, então um reembolso é uma única ação em vez de um chamado de suporte, mas garanta que suas prévias sejam honestas sobre o que o comprador recebe e quando.

Alguns pontos menores que vale conhecer: as Stars no saldo de um bot não são sua propriedade no sentido jurídico, são um saldo que você pode converter; se a conta do dono do bot for excluída, o saldo se perde; e o Fragment pode não conseguir pagar recompensas a usuários em certos países. Leia os termos atuais uma vez antes de construir um negócio em cima disso.

Dicas de preço para Stars

• Use números redondos de Stars. 25, 50, 100, 250, 500. Os usuários pensam em pacotes, e um preço como 73 Stars parece uma conversão de outra moeda.
• Faça as contas com 0,013, não com 0,02. Um produto de 100 Stars rende cerca de 1,30 USD em valor de recompensa, não 2 USD. Precifique seu trabalho de acordo.
• Lembre onde seu público compra. Um público que usa principalmente celular paga o preço da loja de aplicativos; um público de desktop pode comprar mais barato na web ou no Fragment. Avisar os usuários de que as Stars são mais baratas na web é justo e costuma ser bem recebido.
• Respeite o poder de compra regional. Nos bastidores, as Stars são precificadas em dólares. 500 Stars é uma gorjeta fácil em um mercado e uma compra séria em outro. Se seu público é global, mantenha uma faixa baixa (25 ou 50 Stars) ao lado do preço principal.
• Ofereça uma faixa de gorjeta mesmo vendendo produtos. Alguns usuários não vão comprar um produto, mas enviarão 50 Stars com prazer depois de uma resposta útil.
• Planeje-se para a retenção. Com até 21 dias até as Stars ficarem disponíveis, o dinheiro não é caixa da mesma semana. Trate como um repasse mensal.

Como aceitar Stars com o TeleMinute, sem código

O TeleMinute é um criador de bots do Telegram sem código: comandos, respostas por palavra-chave, botões, formulários de leads, transmissões, estatísticas, relatório diário e publicação automática de RSS, na web e em aplicativos nativos para iOS e Android, com a interface em 10 idiomas. Os pagamentos em Stars fazem parte do editor e estão disponíveis no plano Premium ($3.99 por semana, $9.99 por mês ou $49.99 vitalício, com descontos regionais aplicados automaticamente). Aqui está a configuração completa.

1. Conecte seu bot. Crie uma conta no TeleMinute e cole o token do BotFather (nosso guia do BotFather mostra como), ou comece com um bot de demonstração de 15 minutos do pool do TeleMinute e adicione seu próprio token depois. Os pagamentos precisam de um bot que seja seu, então adicione seu token antes de entrar no ar.
2. Crie o que você está vendendo como um comando. No editor do bot, adicione um comando como /checklist e coloque o entregável na resposta dele: texto, até 4 imagens e botões que podem abrir uma URL, por exemplo um download ou um link de convite privado.
3. Ative o Conteúdo pago. No mesmo comando, ative Conteúdo pago. Defina o Preço (Stars), qualquer número inteiro de 1 a 100.000. Escreva um Texto de prévia, o teaser que os usuários veem antes de pagar; deixe em branco e o TeleMinute mostra um aviso padrão de conteúdo bloqueado. Escolha a Entrega: Automática envia o conteúdo do comando logo após o pagamento e o comprador mantém o acesso, então enviar o comando de novo devolve o conteúdo sem uma segunda cobrança; Manual significa que você entra em contato com o comprador e entrega por conta própria, o que se encaixa em consultorias e trabalhos personalizados.
4. Adicione doações e uma loja na aba Pagamentos. Em Doações, ative o recurso, mantenha ou renomeie o comando de doação (/donate por padrão), informe até três valores predefinidos, como 50, 100 e 250 Stars, decida se permite um valor personalizado e escreva uma mensagem de agradecimento. Em Loja, ative um comando de loja (/store por padrão) que lista todos os comandos pagos em um único menu, para que os usuários possam ver o que você vende.
5. Salve e teste com a sua própria conta. Abra seu bot no Telegram, envie o comando pago e confira a prévia e o botão Comprar. Pague uma vez com suas próprias Stars para ver a fatura e a entrega exatamente como um cliente veria. Você pode reembolsar a si mesmo depois.
6. Divulgue. Mencione o comando pago na sua mensagem de /start, adicione um botão que o execute e use uma transmissão para avisar os usuários existentes. Respostas por palavra-chave podem direcionar quem digita "preço" ou "comprar" para o comando da loja.
7. Acompanhe as vendas. A página Vendas de cada bot mostra o total ganho, o total reembolsado e o número de vendas, além de uma linha por pagamento com comprador, item, valor, data e status. Compras com entrega manual ficam marcadas como "Entrega pendente" até você cuidar delas. Cada linha tem Responder, que envia uma mensagem ao comprador pelo seu bot, e Reembolsar, que devolve as Stars ao comprador. O relatório diário pode incluir as vendas em Stars, então você recebe um resumo no Telegram toda manhã.
8. Saque. As Stars vão direto para o saldo do seu bot no Telegram, não para o TeleMinute; o TeleMinute não fica com nenhuma parte das suas vendas. Quando as Stars ficarem disponíveis, use-as no Telegram Ads ou solicite uma recompensa pelo Fragment, seguindo os termos atuais do Telegram.

Nos bastidores, o TeleMinute envia a fatura em XTR, responde à consulta de pré-checkout, verifica o valor, registra o pagamento para que um aviso duplicado não entregue duas vezes e lembra quem já desbloqueou o quê. Você não precisa tocar em nada disso.

Perguntas frequentes

Quanto vale uma Telegram Star?

Depende de que lado do pagamento você está. Os usuários compram Stars em pacotes e, em setembro de 2026, uma Star custa cerca de dois centavos de dólar dentro dos aplicativos iOS e Android, e menos quando comprada pelo Telegram na web ou no Fragment, porque não há comissão da loja de aplicativos. Do lado do dono do bot, os termos do Telegram para desenvolvedores de bots fixam a recompensa no equivalente a 0,013 USD por Star, ou 0,02 USD em crédito de publicidade se você gastar as Stars no Telegram Ads. Os preços variam por região e mudam com o tempo, então confira os termos atuais do Telegram.

Posso vender produtos físicos com Telegram Stars?

Não. Os termos do Telegram reservam as Stars para bens e serviços digitais: conteúdo, acesso, downloads, consultorias, assinaturas, vantagens dentro do bot. Produtos físicos e serviços entregues presencialmente precisam ser vendidos por um provedor de pagamento comum conectado à Bot API do Telegram, ou por um link para o seu próprio checkout. Os comandos pagos, as doações e a loja do TeleMinute funcionam apenas com Stars e, portanto, apenas com produtos digitais.

Como saco as Stars que meu bot ganha?

As Stars pagas ao seu bot vão para o saldo de Stars do próprio bot no Telegram, não para o TeleMinute. Os termos do Telegram para desenvolvedores dizem que as Stars podem levar até 21 dias após o recebimento para ficarem disponíveis; depois disso, você pode gastá-las no Telegram Ads ou solicitar uma recompensa pelo Fragment, que paga em Toncoin ao equivalente a 0,013 USD por Star. O Fragment pode não estar disponível em alguns países e pode haver um valor mínimo, então confira os termos atuais do Telegram antes de contar com isso.

Preciso programar para aceitar Stars com o TeleMinute?

Não. No editor do TeleMinute, você ativa Conteúdo pago em qualquer comando, digita um preço em Stars, opcionalmente adiciona um texto de prévia e escolhe entrega automática ou manual. A aba Pagamentos adiciona um comando de doação com valores predefinidos e um comando de loja que lista todos os comandos pagos. Faturas, confirmação de pré-checkout, entrega, uma página de Vendas com reembolsos e respostas ao comprador: tudo é cuidado para você. Os recursos pagos exigem um plano Premium.