Pagos cripto en un bot de Telegram: cómo añadir pago cripto a tu bot
Pagos cripto en un bot de Telegram: cómo añadir pago cripto a tu bot, qué es el checkout nativo previsto de Qvard y el camino que funciona hoy con la API.
Un bot de Telegram con pagos cripto recoge el pedido en el chat y envía al cliente un botón de pago. Qvard prevé un checkout nativo para Telegram, que todavía no se ha publicado. Esta guía muestra cómo añadir pago cripto a un bot hoy, con la API en vivo, la página alojada y el webhook.
Qué debe hacer el bot
El bot recoge el pedido, crea el pago en tu backend, envía al cliente el botón y espera el webhook. El chat es el escaparate, y el pago en sí ocurre en la página alojada.
Estado: el checkout nativo para bots está en la hoja de ruta
Un checkout nativo de Qvard para bots de Telegram no se ha publicado, y este artículo no lo describe como disponible. La integración de abajo funciona hoy con la 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
}La llamada de pago desde el backend del bot
El backend del bot envía POST /api/v1/payment con la cabecera x-api-key, el id del pedido en id y el total en USD en price. La respuesta contiene el redirectUrl, que se convierte en el botón.
El botón y el mensaje del pedido
Envía un solo mensaje con el pedido, el importe y el botón al redirectUrl. Mantenlo breve y no prometas entrega ni acceso hasta que el webhook confirme el pago.
Recibe el estado en tu backend
Tu endpoint de webhook recibe id y status, comprueba la cabecera x-api-key y actualiza el pedido. Solo el estado paid debe desbloquear el producto o el servicio.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Gestiona repeticiones y fallos
Si el cliente cierra la página, el pedido queda pendiente y el bot puede volver a ofrecer el mismo enlace de pago. Haz el manejador del webhook seguro para repetirse, porque el mismo mensaje puede llegar dos veces.
FAQ
¿Puede un bot de Telegram aceptar cripto hoy?
Sí. El bot crea el pago con la API, envía un botón al redirectUrl y confirma el pedido por webhook. El checkout nativo de Telegram está en la hoja de ruta.
¿Necesito un framework especial para el bot?
No. Cualquier código de bot que pueda llamar a un endpoint HTTPS y recibir un webhook puede crear pagos con la API.
¿Dónde debo guardar la clave de API?
Solo en el backend del bot. Nunca pongas la clave en los mensajes del chat ni en código que el cliente pueda ver.
¿Cómo pruebo el pago del bot?
Crea una factura de demostración desde un pedido de prueba, págala en la página alojada y comprueba que el bot recibe el webhook.
