Aceptar pagos cripto en Telegram: previsto y funcionando hoy
Cómo aceptar pagos cripto en Telegram: un flujo con bot, qué prevé el checkout de Telegram de Qvard y el camino que funciona hoy con la API.
Aceptar pagos cripto en Telegram significa que el cliente paga un pedido dentro de un chat con tu bot. Qvard prevé un checkout de Telegram, que todavía no se ha publicado. Esta guía explica el flujo y el camino que funciona hoy: el bot crea el pago con la API, el botón lleva a la página alojada y el webhook confirma el pedido.
Por qué Telegram es un canal útil
Muchas tiendas y comunidades ya venden con bots y canales de Telegram. Un paso de pago dentro del chat evita tener que enviar al cliente a otro sitio antes de hacer el pedido.
Estado: el checkout de Telegram está en la hoja de ruta
Un checkout nativo de Qvard dentro de Telegram no se ha publicado, y este artículo no lo describe como disponible. El flujo de abajo usa la API en vivo, la página de pago alojada y el webhook.
Qué funciona hoy
El backend del bot crea el pago con POST /api/v1/payment y la cabecera x-api-key, recibe un redirectUrl y lo envía al cliente como botón. El cliente paga en la página alojada, y el webhook entrega el estado final a tu 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
}La llamada desde el servidor del bot
Envía el id del pedido como id y el precio en USD como price desde el backend del bot. Guarda la clave de API en la configuración del servidor, nunca en la lógica del chat que ven los clientes.
Muestra el pedido en el chat
Envía al cliente un mensaje breve con el resumen del pedido y el botón que abre el redirectUrl. Usa un lenguaje sencillo y muestra el total, para que sepa qué está pagando.
Confirma el pedido por webhook
Cuando el webhook entregue el id y el estado paid, marca el pedido como pagado y envía la confirmación al chat. Pulsar el botón no confirma el pedido por sí solo.
FAQ
¿Hay hoy un checkout nativo de Qvard dentro de Telegram?
Todavía no. El checkout de Telegram está en la hoja de ruta. Hoy el bot usa la API, un botón con el redirectUrl y el webhook.
¿Tiene el cliente que salir de Telegram?
La página de pago se abre desde el botón. La conversación sigue en el chat, y el resultado vuelve al bot por tu webhook.
¿Puedo usarlo con un bot que ya tengo?
Sí. Añade la llamada de pago y el botón a la lógica de tu bot existente, y gestiona el webhook en tu backend.
¿Cómo pruebo el flujo 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 confirma el pedido tras el webhook.
