Pagos en mini apps de Telegram: cobrar cripto dentro de una mini app
Pagos en mini apps de Telegram explicados: cobrar cripto dentro de una mini app de Telegram, lo previsto por Qvard para mini apps y el camino de la API hoy.
Los pagos en mini apps de Telegram significan que una tienda hecha como aplicación web dentro de Telegram cobra en cripto por sus artículos. Qvard prevé un checkout para mini apps, que todavía no se ha publicado. Esta guía explica cómo funcionaría un pago en una mini app y el camino que funciona hoy: el backend de la mini app crea el pago con la API, abre la página alojada y confirma el pedido por webhook.
Qué es un pago en una mini app
Una mini app de Telegram es una aplicación web que se abre dentro del chat. Un pago en una mini app significa que el cliente elige un artículo en la app y lo paga sin salir de Telegram durante mucho tiempo.
Estado: el checkout de mini apps está en la hoja de ruta
Un checkout nativo de Qvard para mini apps de Telegram no se ha publicado, y este artículo no lo describe como disponible. El camino de abajo usa la API en vivo, la página de pago alojada y el webhook.
Qué funciona hoy
El backend de la mini app crea el pago con POST /api/v1/payment y la cabecera x-api-key, recibe un redirectUrl y abre la página alojada para el cliente. Después el webhook entrega el estado final al backend, que desbloquea el artículo.
Guarda la clave en el backend
Una mini app se ejecuta en el navegador del cliente, así que la clave de API nunca debe ir en el código del frontend. Solo el backend llama a POST /api/v1/payment.
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
}Desbloquea el artículo con el webhook
La mini app muestra el artículo como desbloqueado solo cuando el webhook ha entregado el id y el estado paid de ese pedido. Hasta entonces el artículo sigue bloqueado, aunque el cliente vuelva a la app.
Planifica el checkout nativo de mini apps
Cuando salga el checkout nativo, la ventana de pago podría abrirse dentro de la app. Hasta entonces, mantén la lógica del pedido y el webhook en el backend, para que después cambie solo el frontend.
FAQ
¿Puede una mini app de Telegram cobrar cripto hoy?
Sí. El backend de la mini app crea el pago con la API, abre la página alojada y desbloquea el artículo cuando el webhook confirma el estado paid. El checkout nativo de mini apps está en la hoja de ruta.
¿Puede la mini app llamar a la API de pagos directamente desde el navegador?
No. Guarda la clave de API en el backend y llama al endpoint de pagos solo desde allí.
¿Tiene el cliente que salir de la mini app?
Hoy se abre la página de pago alojada, y el resultado vuelve a la mini app a través de tu backend y el webhook.
¿Cómo pruebo un pago en una mini app?
Crea una factura de demostración de un artículo de prueba, págala en la página alojada y comprueba que el artículo se desbloquea tras el webhook.
