Pagamentos cripto em bot do Telegram: como adicionar pagamento cripto ao seu bot
Pagamentos cripto em bot do Telegram: como adicionar pagamento cripto ao seu bot, o que é o checkout nativo previsto da Qvard e o caminho que funciona hoje.
Um bot do Telegram com pagamentos cripto recebe o pedido no chat e envia ao cliente um botão de pagamento. A Qvard prevê um checkout nativo para o Telegram, que ainda não foi lançado. Este guia mostra como adicionar pagamento cripto a um bot hoje, com a API em produção, a página hospedada e o webhook.
O que o bot precisa fazer
O bot recolhe o pedido, cria o pagamento no seu backend, envia ao cliente o botão e aguarda o webhook. O chat é a vitrine, e o pagamento em si acontece na página hospedada.
Status: o checkout nativo para bots está no roteiro
Um checkout nativo da Qvard para bots do Telegram ainda não foi lançado, e este artigo não o descreve como disponível. A integração abaixo funciona hoje com a API existente.
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 de pagamento a partir do backend do bot
O backend do bot envia POST /api/v1/payment com o cabeçalho x-api-key, o id do pedido em id e o total em USD em price. A resposta traz o redirectUrl, que se torna o botão.
O botão e a mensagem do pedido
Envie uma única mensagem com o pedido, o valor e o botão para o redirectUrl. Mantenha a mensagem curta e não prometa entrega nem acesso até que o webhook confirme o pagamento.
Receba o status no seu backend
O seu endpoint de webhook recebe id e status, confere o cabeçalho x-api-key e atualiza o pedido. Apenas o status paid deve liberar o produto ou o serviço.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Trate repetições e falhas
Se o cliente fechar a página, o pedido continua pendente e o bot pode oferecer de novo o mesmo link de pagamento. Torne o manipulador do webhook seguro para repetição, porque a mesma mensagem pode chegar duas vezes.
FAQ
Um bot do Telegram pode receber cripto hoje?
Sim. O bot cria o pagamento pela API, envia um botão para o redirectUrl e confirma o pedido pelo webhook. O checkout nativo do Telegram está no roteiro.
Preciso de um framework especial para o bot?
Não. Qualquer código de bot que consiga chamar um endpoint HTTPS e receber um webhook pode criar pagamentos pela API.
Onde guardar a chave da API?
Somente no backend do bot. Nunca coloque a chave nas mensagens do chat nem em código que o cliente possa ver.
Como testar o pagamento 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 recebe o webhook.
