Factura cripto en Telegram: cómo enviar una factura cripto desde tu bot
Factura cripto en Telegram explicada: cómo enviarla desde un bot de Telegram, la factura en el chat prevista por Qvard y qué funciona hoy. Paso a paso.
Una factura cripto en Telegram es una solicitud de pago enviada en un chat con el importe, la moneda y un botón de pago. Qvard prevé un flujo de facturas dentro de Telegram, que todavía no se ha publicado. Esta guía muestra cómo enviar hoy una factura cripto desde un bot: el bot crea la factura con la API y el botón abre la página alojada.
Qué contiene una factura cripto
Una factura muestra el pedido, el importe en USD, el plazo de pago y un botón de pago. El cliente ve lo que debe y puede pagar sin salir de la conversación durante mucho tiempo.
Estado: la factura en el chat está en la hoja de ruta
Un flujo nativo de facturas dentro de Telegram no se ha publicado, y este artículo no lo presenta como disponible. El camino de abajo crea la factura con la API en vivo y la vincula a la página alojada.
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
}Crear la factura desde el bot
El backend del bot llama a POST /api/v1/payment con la cabecera x-api-key, el id del pedido en id y el importe en USD en price. El redirectUrl devuelto es el enlace de la factura que el bot envía al cliente.
Escribe un mensaje de factura claro
Muestra el número de pedido, el importe en USD, lo que compra el cliente y el botón. Añade una nota breve de que el importe exacto en cripto aparecerá en la página siguiente a un tipo de cambio fijo.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Sigue el estado de la factura
El webhook entrega el estado del id de pedido. Mientras el estado no sea paid, la factura sigue abierta, y el bot puede recordárselo al cliente una vez.
Caduca las facturas antiguas
No mantengas una factura sin pagar abierta para siempre. Márcala como caducada en tu sistema según tu propio plazo, y crea un pago nuevo solo cuando el cliente lo pida.
FAQ
¿Puede un bot de Telegram enviar una factura cripto hoy?
Sí. El bot crea el pago con la API, envía el redirectUrl como enlace de la factura y actualiza el pedido desde el webhook. Un flujo nativo de facturas en Telegram está en la hoja de ruta.
¿La factura está pagada cuando el cliente pulsa el botón?
No. La factura solo se paga cuando el webhook entrega el id y el estado paid.
¿Puedo reenviar una factura sin pagar?
Sí, envía el mismo redirectUrl mientras el pago siga abierto, y crea un pago nuevo solo si el anterior caducó.
¿Cómo pruebo una factura?
Crea una factura de demostración y revisa el mensaje, el botón y el resultado del webhook antes de usar pedidos reales.
