Pagamentos no Telegram: como aceitar em 2026

Os pagamentos no Telegram permitem que o comprador pague um bot ou um Mini App sem sair da conversa. O bot envia uma fatura, o Telegram abre a própria tela de pagamento e o dinheiro chega ao vendedor por meio de um provedor de pagamentos (para produtos físicos) ou em Telegram Stars (para produtos digitais). Este guia explica como funcionam os pagamentos no Telegram, qual opção combina com o que você vende, quanto cada uma custa e como começar a receber pagamentos passo a passo, com ou sem programação.

Procurando a lista completa de métodos que uma loja pode conectar, incluindo TON e carteiras do Sudeste Asiático? Ela está em métodos de pagamento no Telegram. Esta página fala de como os pagamentos funcionam no Telegram e de como ativá-los.

Como funcionam os pagamentos no Telegram#

A Bot Payments API do Telegram é uma plataforma aberta e gratuita. Ela tem dois caminhos:

• Produtos físicos e serviços são pagos por meio de provedores terceiros. O Telegram trabalha com mais de 20 deles, e os compradores podem pagar de mais de 200 países. O Telegram não cobra comissão sobre esses pagamentos e não armazena dados de cartão; quem cuida do cartão é o provedor. O Telegram aceita Apple Pay e Google Pay na tela de pagamento.
• Produtos e serviços digitais precisam ser pagos em Telegram Stars, código de moeda XTR. O Telegram avisa que não pode exibir seu bot ou Mini App para usuários de celular se você vender produtos digitais em outras moedas ou por provedores terceiros.

Um pagamento sempre segue o mesmo caminho:

1. Fatura. O bot envia uma fatura com os itens e o total (sendInvoice), ou um Mini App abre uma a partir de um link.
2. Entrega (opcional). Se o frete depende do endereço, o Telegram primeiro pede ao bot as opções de entrega.
3. Verificação antes da cobrança. Antes de cobrar, o Telegram pede ao bot que confirme o pedido. O bot tem 10 segundos para responder; caso contrário, o pagamento é cancelado.
4. Pagamento. O comprador confirma na tela: cartão, Apple Pay, Google Pay ou Stars.
5. Confirmação. O bot recebe uma mensagem successful_payment e entrega o pedido.

Qual opção combina com o que você vende#

As taxas dos provedores variam conforme o país e o contrato. O Stripe publica suas tarifas em stripe.com/pricing; provedores como o Freedom Pay definem as taxas no seu contrato. Confira com o seu provedor, e não numa tabela de blog, o valor que se aplica a você.

Telegram Stars em resumo#

Os compradores adquirem Stars por compras no app pela Apple ou pelo Google, ou pelo @PremiumBot, e depois as gastam em bots e Mini Apps. Para o vendedor, os termos para desenvolvedores de bots do Telegram definem o valor:

• Cerca de $0.013 por Star como recompensa, processada pelo Fragment.
• $0.02 por Star se você usar o saldo em Telegram Ads.
• Até 21 dias até que as Stars recebidas fiquem disponíveis para recompensas ou anúncios.

As Stars só existem em números inteiros, gorjetas não estão disponíveis e o Telegram não repassa nome, telefone nem endereço do comprador num pagamento em Stars. Reembolsos voltam pela Bot API (refundStarPayment), e um bot que vende em Stars precisa responder ao comando /paysupport. A comparação completa com cartões, com uma tabela de conversão de Stars para USD, está em Telegram Stars vs Stripe.

Como aceitar pagamentos no Telegram (o caminho geral)#

Se você mesmo desenvolver o bot, estes são os passos da documentação do Telegram:

1. Crie um bot com o @BotFather. Nosso guia de bots mostra o processo.
2. Obtenha um token do provedor. No @BotFather: /mybots → seu bot → Bot Settings → Payments. Escolha um provedor, conclua o cadastro e copie o token. Comece pelo token de teste. Para Stars, pule esta etapa: o token é uma string vazia.
3. Envie faturas pelo seu código com sendInvoice ou createInvoiceLink, numa moeda aceita pelo seu provedor.
4. Responda à consulta de pré-checkout em até 10 segundos, e à consulta de entrega se você usar frete flexível.
5. Trate o successful_payment: marque o pedido como pago e envie os produtos.
6. Cumpra a checklist do Telegram para entrar em produção: verificação em duas etapas na conta dona do bot, um comando /terms que os compradores aceitam, um comando /support e disposição para resolver disputas e chargebacks por conta própria. Depois troque o token de teste pelo de produção (ele tem :LIVE: no meio).

Uma plataforma de lojas faz os passos 3 a 5 por você, junto com o catálogo, o carrinho e os alertas de pedido.

Como aceitar pagamentos no Telegram com o Tiny Shops#

O Tiny Shops é um criador de lojas em Mini App do Telegram sem código. Sua loja abre dentro do seu próprio bot, e o checkout termina na tela de pagamento do Telegram.

Cartões por um provedor do Telegram#

1. Obtenha um token de teste no @BotFather → /mybots → o bot da sua loja → Bot Settings → Payments. Guias passo a passo para dois provedores: Stripe e Freedom Pay.
2. Abra Storefront Settings → Orders & Payments. Em Checkout Mode, escolha Telegram Payments.

3. Clique em Add Provider. Preencha Provider Name (qualquer nome, por exemplo "Stripe"), cole o token em Provider Token, deixe Test Mode e Active ligados e clique em Save Provider.
4. Confira a moeda da loja em Store Currency. Ela precisa ser aceita pelo seu provedor. Se um pagamento falhar com PAYMENT_PROVIDER_INVALID, a moeda costuma ser a causa.
5. Abra Checkout → Payment methods e verifique se Telegram Invoice está na lista. Se não estiver, clique em Add method e adicione. Ele aparece como Connected assim que houver um provedor ativo.

6. Escolha os campos da fatura. Em Invoice Field Configuration, ative Request Name, Request Phone Number, Request Email ou Request Shipping Address conforme precisar. Flexible Shipping Pricing faz o preço da entrega depender do endereço. Enable Tips adiciona até 4 valores sugeridos de gorjeta e um Maximum Tip Amount.
7. Faça um pedido de teste pelo celular. Com um token de teste do Stripe, use o cartão de teste do Telegram 4242 4242 4242 4242, qualquer data futura e qualquer CVC.
8. Entre em produção. Pegue o token de produção no @BotFather, clique em Edit Provider, cole o token, desligue Test Mode e salve.

Telegram Stars#

1. Em Storefront Settings → Orders & Payments, escolha Telegram Payments e defina Store Currency como Telegram Stars (XTR). A página mostra Telegram Stars Enabled: sem token e sem configurações.
2. Em Checkout → Payment methods, adicione Telegram Stars.
3. Defina os preços dos produtos em Stars inteiras.

Cada loja tem uma única moeda, então uma loja aceita ou Stars ou um provedor de cartão. Se você vende tanto encomendas físicas quanto produtos digitais, mantenha duas lojas na mesma conta.

Outras opções#

Stripe Connect (cartões na página de checkout do Stripe, repasses para a sua própria conta Stripe), TON, Xendit para Indonésia, Filipinas e Malásia, e Pedido manual (Manual order) são todos configurados em Checkout → Payment methods. Os passos de cada um estão em métodos de pagamento no Telegram.

Apple Pay e Google Pay no Telegram#

Você não precisa ativar as carteiras separadamente. A tela de pagamento do Telegram aceita Apple Pay e Google Pay, e elas aparecem quando o seu provedor e o aparelho do comprador são compatíveis. Se um comprador não vê o Apple Pay, verifique se o seu provedor oferece esse recurso no seu país. Pagamentos em Stars não usam carteiras: o comprador paga com o saldo de Stars.

Quanto custa#

O Telegram não fica com nada nos pagamentos por provedor; o seu provedor cobra a própria taxa. O Tiny Shops custa $0 no Free, $9.99 no Starter, $29 no Pro e $79 no Scale por mês, e cada pedido paga o percentual do plano sobre o total: 5%, 3%, 1.5% ou 0.7%. Cada conta recebe os primeiros 50 pedidos grátis, uma única vez, não todo mês. Vendas em Stars pagam o percentual desde a primeira venda. O Pro paga no máximo $149 por mês em percentual, o Scale no máximo $79. Detalhes em preços.

Solução de problemas#

Perguntas frequentes#

Como funcionam os pagamentos no Telegram? O bot envia uma fatura, o Telegram mostra uma tela de pagamento nativa, o comprador paga com cartão, carteira digital ou Stars, e o bot recebe a confirmação e entrega o pedido. Cartões passam por um provedor terceiro; as Stars ficam dentro do Telegram.

O Telegram cobra taxa sobre os pagamentos? Não nos pagamentos por provedores terceiros; o provedor cobra a própria taxa. Com Stars, o vendedor recebe cerca de $0.013 por Star como recompensa, conforme os termos para desenvolvedores do Telegram.

Dá para aceitar Apple Pay no Telegram? Sim, quando o seu provedor oferece. Apple Pay e Google Pay aparecem na tela de pagamento do Telegram sem configuração extra na loja.

Posso vender produtos digitais por cartão no Telegram? Não dentro do bot ou do Mini App. O Telegram exige Stars para produtos e serviços digitais e pode esconder dos usuários de celular um bot que os venda em outras moedas.

Preciso de um desenvolvedor? Não com uma plataforma de lojas. No Tiny Shops, a configuração é um token do @BotFather e alguns ajustes no painel.

Abra sua loja e receba seu primeiro pagamento no Telegram em tiny-shops.com →