Ventana emergente de pago cripto: cómo funciona y qué está previsto
Ventana emergente de pago cripto explicada: cómo funciona, qué prevé el SDK de Qvard para ella y qué puedes ejecutar hoy. Con código. Con ejemplos.
Una ventana emergente de pago cripto es una ventana de pago que se abre sobre la página actual, de modo que el cliente paga sin salir del sitio. La ventana está prevista como parte del SDK de Qvard y todavía no se ha publicado. Esta guía explica cómo funciona y qué puedes ejecutar hoy con la API.
Cómo funciona una ventana de pago
La página llama a una función, se abre una ventana sobre el contenido, el cliente completa el pago en ella y la ventana se cierra. La tienda se queda en segundo plano y el pedido se confirma en el servidor.
Estado: la ventana está en la hoja de ruta
La ventana emergente de checkout de Qvard no se ha publicado, y este artículo no la describe como función terminada. El código de los medios es una vista previa de la llamada prevista.
Qué funciona hoy
Crea el pago con POST /api/v1/payment y la cabecera x-api-key, y redirige al cliente al redirectUrl de la página de checkout alojada. Recibe el estado final por webhook. Así el cliente obtiene el mismo resultado de pago sin ventana emergente.
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
}Abrir una ventana nueva con cuidado
Si prefieres una ventana aparte, abre el redirectUrl en una pestaña nueva solo después de un clic. Los navegadores bloquean las ventanas que se abren sin acción del usuario, así que el clic debe ser lo primero.
Confirma el pago en el servidor
La ventana, cuando llegue, mostrará el progreso en la página, pero el estado pagado debe seguir viniendo del webhook. Construye ya la lógica del pedido alrededor del webhook.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Qué evitar
No consideres un pago fallido una ventana cerrada, ni marques el pedido como pagado al cerrarse la ventana. Espera el resultado del webhook.
FAQ
¿Hay hoy una ventana emergente de pago de Qvard?
Todavía no. La ventana está prevista dentro del SDK, en la hoja de ruta. Hoy basta la página de checkout alojada o una pestaña nueva.
¿Puede abrirse una ventana sin clic?
Los navegadores suelen bloquearlo. Abre la página de pago después de un clic del usuario.
¿Qué pasa si el cliente cierra la ventana?
No decidas el resultado por el evento de cierre. Consulta el estado del pedido en el webhook.
¿Cómo pruebo el flujo?
Crea una factura de demostración y verifica el resultado del webhook.
