Guia de Configuração, Regras dos Stars e Taxas Reais
O Telegram requer sua própria moeda Stars (XTR) para bens e serviços digitais vendidos dentro de bots e Mini Apps.
Os gateways de pagamento em criptomoeda entram para tudo que as Stars não cobrem: serviços do mundo real, bens físicos, saldos de plataforma, depósitos e pagamentos B2B. Este guia explica o que é realmente permitido, duas maneiras práticas de configurar a aceitação de criptomoedas, o que custa e uma solução alternativa para a única coisa que a criptomoeda ainda não consegue fazer — assinaturas recorrentes.
Principais Conclusões
Existem duas maneiras práticas de aceitar criptomoedas de um Mini App ou bot do Telegram: custódia automatizada e não custódia automatizada (contrato inteligente).
Nenhuma blockchain atualmente suporta assinaturas recorrentes reais sem sérios compromissos de segurança — a solução prática é um saldo recarregável dentro do aplicativo.
Pagamentos com cartão dentro do WebView de um Mini App frequentemente enfrentam dificuldades com 3D Secure e verificações de fraude — uma razão prática pela qual as criptomoedas tendem a funcionar de forma mais suave nesse ambiente específico.
Mini Apps falsos criados para drenar carteiras conectadas são uma ameaça ativa e crescente em 2026.
Bots vs. Mini Apps
A maioria do conteúdo "como aceitar criptomoedas no Telegram" na verdade se refere a bots — você envia um link de pagamento ou uma fatura como uma mensagem de chat, o usuário clica e um navegador (ou o checkout embutido) se abre.
Um Mini App é diferente: é uma aplicação web completa que se abre diretamente dentro do Telegram como um WebView, com sua própria interface, navegação e — se você quiser — seu próprio fluxo de pagamento embutido na interface em vez de anexado como um link.
Crypto Wallet — acessível pelo ícone de anexo em qualquer chat do Telegram — é um bom exemplo de como isso realmente se sente na prática: saldos, fluxos de envio/recebimento, sua própria navegação, tudo sem sair do chat.
Se você está construindo um serviço de assinatura, um marketplace ou uma plataforma de iGaming, você quase certamente está construindo um Mini App, não um simples bot. Os passos de configuração abaixo se aplicam a ambos, mas a experiência de checkout é visivelmente melhor dentro de um Mini App porque a página de pagamento pode viver dentro da sua interface em vez de redirecionar o usuário para outro lugar.
Telegram Stars vs. gateways de criptomoeda
A documentação de Pagamentos de Bot do Telegram exige que bens e serviços digitais vendidos dentro de um bot ou Mini App usem Telegram Stars (código da moeda XTR) — não cartões, não criptomoeda. Isso abrange coisas como desbloquear conteúdo premium, comprar moeda dentro do aplicativo para um jogo ou pagar por uma assinatura digital que é consumida inteiramente dentro do Telegram.
Volet.com · Verificação de pagamentos do Telegram
Estrelas, ou um gateway de criptomoeda?
Escolha o que você está vendendo. A resposta segue os próprios Termos de Serviço do Desenvolvedor de Bot do Telegram, não conselhos gerais.
Onde os gateways de pagamento em criptomoedas são a ferramenta certa e legítima:
Serviços entregues fora do Telegram — uma conexão VPN, hospedagem, um produto SaaS, consultoria, qualquer coisa que o usuário consuma fora da plataforma, mesmo que pague por isso dentro de um bot do Telegram.
Produtos físicos — qualquer coisa enviada ou entregue pessoalmente.
Salários e depósitos na plataforma — recarregar uma carteira dentro do seu próprio aplicativo (esta também é a solução prática para o problema de assinatura abaixo).
Pagamentos B2B e transfronteiriços — pagamentos de afiliados, liquidações de mercado entre empresas, que estão completamente fora da definição de "bens digitais vendidos no aplicativo" do Telegram.
Pagamentos com cartão dentro do WebView de um Mini App
Há uma razão técnica pela qual as criptomoedas tendem a parecer mais suaves do que os cartões especificamente dentro do ambiente do Telegram. Mini Apps rodam dentro de um WebView — um navegador embutido, não um completo — e os processadores de cartão frequentemente têm dificuldades com esse ambiente: verificações antifraude podem falhar, e janelas de confirmação 3D Secure frequentemente não abrem corretamente ou não devolvem o controle à página, deixando o cliente preso no meio do pagamento sem um próximo passo claro.
As criptomoedas contornam esse problema, porque não há rede de cartões e nenhum passo 3D Secure no loop que possa quebrar dentro de um WebView em primeiro lugar. Vamos detalhar isso mais.
Duas maneiras de aceitar criptomoedas no Telegram
Claro que você sempre pode compartilhar um endereço de carteira manualmente e verificar os pagamentos você mesmo — mas isso não escala além de faturas ocasionais. Para qualquer coisa que você está construindo para durar, você realmente está escolhendo entre dois modelos automatizados.
Aceitação custodial automatizada
Isso é o que a maioria das empresas realmente deseja. Você integra um gateway de pagamento — via API ou Checkout Hospedado — e ele gerencia todo o fluxo:
O gateway gera automaticamente uma fatura e detalhes de pagamento para cada compra, puxando um endereço de um pool e calculando o valor devido.
O cliente envia o pagamento; o gateway automaticamente o associa à fatura.
O gateway notifica seu backend via webhook assim que o pagamento é confirmado, para que você possa entregar o acesso automaticamente.
Os fundos são creditados ao seu saldo de comerciante — seja na mesma criptomoeda com a qual o cliente pagou, ou automaticamente convertidos em uma stablecoin ou moeda fiduciária, o que é útil se seu preço estiver definido em USD e você não quiser exposição à volatilidade das criptomoedas.
Dentro do Telegram, isso parece diferente dependendo de como você integra:
Via API, você constrói a interface você mesmo nas mensagens do seu bot ou dentro das telas do seu próprio Mini App.
Via Checkout Hospedado, o Mini App abre um webview com uma página de pagamento pronta — nenhum desenvolvimento de backend necessário do seu lado, e funciona da mesma forma, quer você esteja construindo um bot ou um Mini App completo.
Esta é a aparência da página de Checkout Hospedado do Volet.com
Aceitação automatizada não custodial (contrato inteligente)
Aqui, os fundos nunca passam pelo gateway. O cliente conecta sua própria carteira diretamente ao seu checkout e paga através de um contrato inteligente diretamente para sua carteira. O gateway cobra uma pequena taxa de processamento, mas nunca custodia os fundos; a liquidação acontece inteiramente dentro da própria transação.
O fluxo real do usuário é assim:
O cliente clica em "Conectar Carteira."
Ele é redirecionado para o aplicativo da carteira para aprovar a conexão — no celular, isso abre o próprio aplicativo da carteira; no desktop, uma extensão do navegador ou escaneamento de QR.
Ele é retornado ao seu checkout.
Ele confirma os detalhes da transação.
Ele é redirecionado para sua carteira novamente para assinar o pagamento.
Ele é retornado a uma página de confirmação, que aguarda a transação ser finalizada na blockchain antes de marcar o pedido como completo.
Mais um detalhe técnico: a notificação da API não faz parte do contrato inteligente. A transferência na blockchain em si é a única coisa que acontece na blockchain — tudo o mais (atualizando o status do pedido, concedendo acesso, enviando uma confirmação) é lógica de backend separada do seu lado, acionada pelo webhook assim que o gateway detecta a transação.
Esse fluxo exato — conectar a carteira, assinar uma transação — é também o que os golpistas imitam. Clones fraudulentos de Mini Apps populares de ganhar dinheiro ao tocar, incluindo imitações de Notcoin e Hamster Kombat, levaram os usuários a conectar suas carteiras apenas para que um contrato inteligente malicioso drenasse os fundos instantaneamente e de forma irreversível.
Isso não torna a Conexão de Carteira insegura por design, mas a legitimidade precisa ser visivelmente óbvia: um domínio de pagamento consistente e verificável, uma aprovação de gastos fixa e itemizada em vez de uma aberta, e uma regra rígida de que um checkout real nunca pede uma frase-semente ou um depósito antecipado — apenas uma assinatura do próprio aplicativo de carteira do cliente.
TON (The Open Network), recentemente renomeado de volta para seu nome original Gram, é a única escolha para o TON Connect no fluxo não custodial acima. Isso não é uma recomendação — é uma regra. Os próprios Termos de Serviço para Desenvolvedores de Bots do Telegram exigem que qualquer Mini App que toque na funcionalidade de carteira se conecte exclusivamente através do TON Connect.
Por que o Telegram impõe isso: TON é a própria blockchain do Telegram, e a empresa tem uma participação direta e crescente em seu sucesso. Em maio de 2026, o Telegram assumiu o controle direto da infraestrutura do TON: a empresa apostou 2,2 milhões de tokens para se tornar o maior validador da rede, substituindo a Fundação TON como o principal operador.
A aceitação custodial através da API do Volet.com ou do Checkout Hospedado não enfrenta isso de forma alguma — não há etapa de conexão de carteira acontecendo dentro do Mini App em si, então quais ativos você pode aceitar não é restrito da mesma forma.
Nenhuma blockchain hoje suporta cobrança recorrente automática da maneira que uma rede de cartões faz — as aproximações mais próximas exigem dar a um contrato inteligente permissão permanente para retirar fundos indefinidamente (um compromisso de segurança significativo que a maioria das empresas não deve aceitar) ou construir algo tão frágil que não vale a pena ser enviado.
A solução prática é um saldo recarregável em vez de uma assinatura:
O usuário recarrega um saldo dentro do seu Mini App usando criptomoedas — através do mesmo fluxo custodial ou não custodial descrito acima.
Seu app deduz o custo da assinatura desse saldo em um cronograma que você controla.
Você pode até manter e exibir esse saldo em termos fiduciários (para que o usuário veja "$9,99 restantes" em vez de um valor de criptomoeda flutuante) enquanto ainda aceita a recarga em criptomoedas.
Isso requer um pouco mais de trabalho de desenvolvimento dentro do seu Mini App, mas é a versão que realmente é enviada hoje sem pedir aos usuários que entreguem permissão permanente a um contrato inteligente.
A oferta do Volet.com para pagamentos no Telegram
A aquisição de criptomoedas através do Volet.com não requer um faturamento mínimo para começar, sem taxas de configuração para a API ou Checkout Hospedado, e sem custo de assinatura mensal.
Modelo
Taxa do comerciante
Taxa de retirada
Custodial (API ou Checkout Hospedado)
A partir de 0,25%
A partir de $0,5 fixo (mais se converter — veja abaixo)
Não custodial (contrato inteligente)
0,25%
Nenhuma — os fundos vão diretamente para sua carteira
A taxa acima é o nível base para aceitar pagamentos sem conversão. A conversão opcional na liquidação é precificada separadamente — e o caso mais comum, stablecoins em USD, não custa nada extra. Aqui está o que a conversão realmente custa na liquidação:
Exemplo: a recarga única de saldo de $9,99 do serviço de VPN paga em USDT.
Custodial (API ou Checkout Hospedado):
O cliente envia 9,99 USDT de sua própria carteira.
Você é creditado com $9,99 menos a taxa de aquisição de 0,25% (cerca de $0,02), então aproximadamente $9,97 vai para o seu saldo comercial do Volet.com.
Esse saldo se acumula com cada recarga de cliente, e o que custa para retirá-lo depende do que você faz a seguir.
Opção mais barata: pule o fiat e retire, digamos, $1.000 para sua própria carteira de cripto no mesmo ativo — apenas a taxa de rede fixa (cerca de $0,5–3,5 dependendo da rede), então você manteria aproximadamente $996,50–$999,50.
Se você quiser fiat, converta no momento em que aceitar cada pagamento (liquidando em USD em vez de manter USDT) em vez de converter depois — essa conversão é gratuita, então retirar o saldo resultante de $1.000 USD para seu banco custa apenas a taxa de retirada, a partir de 1% dependendo do método, deixando você com aproximadamente $990.
Converter um saldo de USDT já acumulado para USD depois do fato, dentro da sua conta, custa 1% além disso — além da mesma taxa de retirada — então você acabaria com aproximadamente $980 em vez disso.
Não custodial (contrato inteligente):
O cliente conecta sua carteira e assina o mesmo pagamento de 9,99 USDT.
O contrato inteligente direciona o pagamento diretamente para sua própria carteira, menos a mesma taxa de processamento de 0,25% — você recebe aproximadamente $9,97, já sentado em sua própria carteira.
Não há uma etapa de retirada separada e nenhuma taxa de retirada, porque os fundos nunca estiveram com o gateway para começar.
Escale isso para os mesmos $1.000 em pagamentos totais de clientes usados no exemplo custodial acima, e a comparação é direta: $997,50 vai diretamente para sua própria carteira.
Volet.com ajuda a construir seus pagamentos globais
Em fiat, cripto e stablecoins. Via API, checkout hospedado ou plugins fáceis de instalar. Aceite, envie e gerencie fundos — tudo a partir do código.
Não. O Checkout Hospedado não requer desenvolvimento de backend — o Mini App abre uma webview de pagamento pronta.
Mas uma integração completa de API também está disponível se você quiser mais controle sobre a experiência de checkout.
Você pode começar como um indivíduo.
A aquisição de criptomoedas tem uma barreira de entrada notavelmente mais baixa do que as vias de pagamento tradicionais hoje: não é necessário uma entidade legal separada, conta bancária empresarial ou consultoria jurídica dedicada para conectá-la, e um desenvolvedor solo pode configurar a aceitação custodial ou não custodial diretamente.
Sim, com a aceitação custodial, os pagamentos de criptomoedas recebidos podem ser automaticamente convertidos em USD ou EUR na liquidação, de modo que seu saldo não se mova com os preços das criptomoedas, mesmo que seu cliente tenha pago em um ativo volátil.
Os pagamentos não custodiais se liquidam diretamente no que o cliente pagou, uma vez que não há uma etapa de conversão intermediária nesse fluxo.
As ferramentas para automatizar a contabilidade de criptomoedas e a declaração de impostos ainda são muito menos maduras do que o que existe para receita de cartões ou bancos — um verdadeiro ponto de dor se você precisar de livros limpos e prontos para auditoria.
Converter pagamentos recebidos em uma stablecoin ou fiat na liquidação (disponível com a aceitação custodial da Volet.com) remove a complexidade adicional de rastrear os movimentos de preços das criptomoedas além das transações em si.
