Como aceitar pagamentos em cripto em um bot do Telegram (USDT passo a passo)
Bots do Telegram e comunidades pagas vivem de entrega instantânea. Veja como conectar um gateway de pagamento cripto ao seu bot para que os usuários paguem em USDT e recebam o acesso automaticamente.
Para aceitar pagamentos em cripto em um bot do Telegram, faça o backend do bot criar uma fatura pela API de um gateway de pagamento cripto quando o usuário tocar em “Comprar”, envie o link de checkout retornado como botão inline e escute o webhook assinado do gateway. Quando o pagamento for confirmado, o bot entrega automaticamente o produto, a chave ou o convite do canal.
Bots do Telegram e comunidades pagas são dos casos que mais combinam com checkout em cripto: os usuários são internacionais, muitos já têm USDT e esperam receber em segundos. Este guia mostra a arquitetura, o fluxo de mensagens e os detalhes que deixam tudo confiável.
Por que cripto funciona tão bem em bots do Telegram
- Público global: os usuários de bots vêm de todo lugar; um único preço em USDT serve para todos.
- Pagamento mobile-first: o checkout hospedado abre no navegador do Telegram, e o app da carteira pode ler o QR code ou copiar o endereço.
- Automação instantânea: um webhook assinado permite que o bot entregue sem ninguém conferir um explorador de blocos.
- Redes rápidas: na TRON e na BNB Smart Chain os pagamentos costumam confirmar em cerca de um minuto.
Bots do Telegram e comunidades pagas são um dos principais casos de uso para os quais o mistKET foi criado, ao lado de SaaS, hospedagem e produtos digitais.
Arquitetura: três componentes
| Componente | Função |
|---|---|
| Bot do Telegram (via Bot API) | Conversa com o usuário: menus, botões, mensagens de entrega |
| Seu backend | Guarda pedidos, chama a API do gateway, recebe webhooks, guarda os segredos |
| Gateway mistKET | Checkout hospedado, monitoramento da blockchain, confirmações, liquidação |
Seja qual for o framework, o padrão para aceitar pagamentos em cripto em um bot do Telegram é o mesmo. O bot e o backend costumam ser o mesmo serviço pequeno. O que importa é que os segredos de API e de webhook fiquem no servidor — nunca dentro de mensagens nem em código do lado do cliente. A documentação oficial do Telegram para bots está em core.telegram.org.
Passo a passo: aceitar pagamentos em cripto em um bot do Telegram
- O usuário escolhe um produto — por exemplo “Acesso de 1 mês” num teclado inline. Seu backend cria um pedido com o ID do usuário no Telegram.
- O backend cria uma fatura — um único
POST /api/v1/invoicesassinado com valor, moeda, ID do pedido e uma URL de callback. - O bot envia um botão de pagar — um botão de URL inline apontando para o
checkout_urlretornado, com uma nota curta: “Envie o valor exato na rede que escolher.” - O usuário paga — na página hospedada escolhe USDT na TRON, BSC, Ethereum ou Arbitrum (ou TRX, BNB, ETH) e paga pela carteira ou corretora.
- O webhook chega — após as confirmações, seu callback recebe um evento assinado
invoice.confirmedcom o ID do seu pedido. - O bot entrega — verifique a assinatura, marque o pedido como pago e envie no chat do usuário a chave de licença, o arquivo ou um link de convite do canal de uso único.
Um modelo de dados mínimo
Você não precisa de um banco de dados complexo para rodar um bot pago. Três tabelas resolvem a maioria dos casos:
| Tabela | Campos principais | Finalidade |
|---|---|---|
| users | telegram_id, username, access_until | Quem tem acesso e até quando |
| orders | order_id, telegram_id, product, amount, status | Uma linha por tentativa de compra |
| invoices | order_id, invoice_uuid, checkout_url, network, paid_amount | Ligação entre seu pedido e a fatura do gateway |
Quando o webhook chegar, busque o pedido pelo order_id, confira se ele ainda não foi entregue, atualize o status e mande mensagem ao usuário pelo telegram_id. Esse é todo o ciclo de entrega.
Exemplos de mensagens
Textos claros no chat reduzem os chamados de suporte. Uma sequência que funciona bem:
- Mensagem da fatura: “Seu pedido: acesso de 1 mês, 15 USD. Toque em Pagar para abrir a página de pagamento segura. Envie o valor exato na rede que escolher.”
- Pago: “Pagamento detectado. Aguardando as confirmações da rede — costuma levar um ou dois minutos.”
- Confirmado: “Pagamento confirmado. Aqui está seu link de convite — ele funciona uma única vez.”
- Pago a menor: “Recebemos menos do que o valor da fatura. Abra a mesma página de pagamento para enviar a diferença.”
- Expirada: “Esta fatura expirou. Toque abaixo para gerar uma nova.”
Suporte sem prints
Quando um usuário perguntar sobre um pagamento, peça só o número do pedido. Ao abrir a fatura no painel do lojista você vê o valor esperado, o valor recebido, a rede e o hash da transação, então nunca precisa de prints ou endereços de carteira do usuário. Um botão “Suporte” no bot pode repassar o número do pedido automaticamente, transformando a maioria das dúvidas de pagamento numa consulta de dez segundos em vez de uma longa conversa.
Boas práticas de UX dentro do chat
- Envie atualizações de status. No
invoice.paid, responda “Pagamento visto, aguardando confirmações”; noinvoice.confirmed, entregue. - Mostre o preço em dólar e deixe o gateway converter. A cotação fica travada durante a validade da fatura.
- Explique a contagem regressiva uma vez, para ninguém se assustar ao ver um cronômetro.
- Ofereça um botão “Ver status” que consulta a fatura pela API — útil se o usuário voltar mais tarde.
- Trate pagamentos a menor com educação. No
invoice.underpaid, diga quanto falta; pagamentos parciais se somam até o total. - Trate a expiração. No
invoice.expired, ofereça uma fatura nova com um toque.
Assinaturas e comunidades pagas
Para acesso mensal, crie uma nova fatura ao fim de cada período e envie como mensagem de renovação alguns dias antes. Quando chegar o invoice.confirmed, estenda a data de acesso do usuário no seu banco. Se nenhum pagamento chegar antes do fim do período, remova o acesso. Transferências em cripto são enviadas por quem paga, então toda renovação é uma fatura que o usuário paga — não existe débito automático como no cartão.
Checklist de confiabilidade
- Idempotência: os webhooks são reenviados com intervalo crescente por horas, então o mesmo evento pode chegar duas vezes. Confira se o pedido já foi entregue antes de enviar qualquer coisa.
- Verificação de assinatura: valide o
X-Mistket-Signature(HMAC-SHA256 do timestamp e do corpo bruto com seu segredo de webhook) antes de confiar em qualquer evento. - Mensagem no chat não é prova. Um usuário dizendo “já paguei” ou mandando print nunca substitui o webhook.
- Lista de IPs permitidos: restrinja o acesso à API ao servidor do seu bot no painel do lojista.
- Logs: o painel mostra os logs de entrega dos webhooks, valores esperado e recebido e hashes de transação para os casos de suporte.
Para exemplos de código completos de assinatura e verificação, veja integração de API de pagamento cripto.
Ainda sem desenvolvedor? Comece com links de pagamento
Se você administra um pequeno grupo pago manualmente, pode criar faturas no painel do lojista e enviar o link por mensagem privada. Depois de confirmar o pagamento no painel, adicione o membro à mão. Não escala, mas permite validar o preço antes de construir um bot. Veja links de pagamento e faturas em cripto.
Comece agora
Pronto para aceitar pagamentos em cripto no seu próprio bot do Telegram? Peça sua conta de lojista pelo Telegram @mistnetwork com o link do bot ou da comunidade e o volume esperado. Após a aprovação, você recebe as chaves de API no mesmo dia. Veja os exemplos de requisição e webhook na seção para desenvolvedores e gerencie suas chaves pelo login do lojista.
