Aceitar pagamentos cripto no Telegram: previsto e funcionando hoje
Como aceitar pagamentos cripto no Telegram: um fluxo com bot, o que o checkout do Telegram da Qvard prevê e o caminho que funciona hoje com a API.
Aceitar pagamentos cripto no Telegram significa que o cliente paga um pedido dentro de um chat com o seu bot. A Qvard prevê um checkout para o Telegram, que ainda não foi lançado. Este guia explica o fluxo e o caminho que funciona hoje: o bot cria o pagamento pela API, o botão leva à página hospedada e o webhook confirma o pedido.
Por que o Telegram é um canal útil
Muitas lojas e comunidades já vendem por bots e canais do Telegram. Uma etapa de pagamento dentro do chat evita enviar o cliente para outro site antes de fazer o pedido.
Status: o checkout do Telegram está no roteiro
Um checkout nativo da Qvard dentro do Telegram ainda não foi lançado, e este artigo não o descreve como disponível. O fluxo abaixo usa a API em produção, a página hospedada e o webhook.
O que funciona hoje
O backend do bot cria o pagamento com POST /api/v1/payment e o cabeçalho x-api-key, recebe um redirectUrl e o envia ao cliente como botão. O cliente paga na página hospedada, e o webhook entrega o status final ao seu backend.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}A chamada a partir do servidor do bot
Envie o id do pedido em id e o preço em USD em price a partir do backend do bot. Guarde a chave da API na configuração do servidor, nunca na lógica do chat que os clientes veem.
Mostre o pedido no chat
Envie ao cliente uma mensagem curta com o resumo do pedido e o botão que abre o redirectUrl. Use linguagem simples e mostre o total, para que ele saiba o que está pagando.
Confirme o pedido pelo webhook
Quando o webhook entregar o id e o status paid, marque o pedido como pago e envie a confirmação no chat. Um clique no botão, sozinho, não confirma o pedido.
FAQ
Existe hoje um checkout nativo da Qvard dentro do Telegram?
Ainda não. O checkout do Telegram está no roteiro. Hoje o bot usa a API, um botão com o redirectUrl e o webhook.
O cliente precisa sair do Telegram?
A página de pagamento abre pelo botão. A conversa continua no chat, e o resultado volta ao bot pelo seu webhook.
Posso usar isso com um bot que já tenho?
Sim. Acrescente a chamada de pagamento e o botão à lógica do seu bot existente, e trate o webhook no seu backend.
Como testar o fluxo do bot?
Crie uma fatura de demonstração a partir de um pedido de teste, pague na página hospedada e confira se o bot confirma o pedido após o webhook.
