Fatura cripto no Telegram: como enviar uma fatura cripto pelo seu bot
Fatura cripto no Telegram explicada: como enviar uma fatura cripto por um bot do Telegram, o que a Qvard prevê para a fatura no chat e o que funciona hoje.
Uma fatura cripto no Telegram é um pedido de pagamento enviado no chat com o valor, a moeda e um botão de pagamento. A Qvard prevê um fluxo de faturas dentro do Telegram, que ainda não foi lançado. Este guia mostra como enviar hoje uma fatura cripto pelo bot: o bot cria a fatura pela API e o botão abre a página hospedada.
O que uma fatura cripto contém
Uma fatura mostra o pedido, o valor em USD, o prazo de pagamento e um botão de pagamento. O cliente vê o que deve e pode pagar sem sair da conversa por muito tempo.
Status: a fatura no chat está no roteiro
Um fluxo nativo de faturas dentro do Telegram ainda não foi lançado, e este artigo não o apresenta como disponível. O caminho abaixo cria a fatura pela API em produção e a vincula à página hospedada.
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
}Crie a fatura pelo bot
O backend do bot chama POST /api/v1/payment com o cabeçalho x-api-key, o id do pedido em id e o valor em USD em price. O redirectUrl devolvido é o link da fatura que o bot envia ao cliente.
Escreva uma mensagem de fatura clara
Mostre o número do pedido, o valor em USD, o que o cliente está comprando e o botão. Acrescente uma nota curta de que o valor exato em cripto aparece na página seguinte, com taxa fixa.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Acompanhe o status da fatura
O webhook entrega o status do id do pedido. Enquanto o status não for paid, a fatura continua aberta, e o bot pode lembrar o cliente uma vez.
Faça as faturas antigas expirarem
Não mantenha uma fatura não paga aberta para sempre. Marque-a como expirada no seu sistema após o seu próprio prazo, e crie um pagamento novo só quando o cliente pedir.
FAQ
Um bot do Telegram pode enviar uma fatura cripto hoje?
Sim. O bot cria o pagamento pela API, envia o redirectUrl como link da fatura e atualiza o pedido pelo webhook. Um fluxo nativo de faturas no Telegram está no roteiro.
A fatura é paga quando o cliente toca no botão?
Não. A fatura só é paga quando o webhook entrega o id e o status paid.
Posso reenviar uma fatura não paga?
Sim, envie o mesmo redirectUrl enquanto o pagamento estiver aberto, e crie um pagamento novo somente se o anterior tiver expirado.
Como testar uma fatura?
Crie uma fatura de demonstração e confira a mensagem, o botão e o resultado do webhook antes de usar pedidos reais.
