Ejemplo de pago cripto en JavaScript: un flujo que funciona hoy
Ejemplo de pago cripto en JavaScript: un flujo funcional con la API v1 en vivo, una llamada de servidor y un webhook, y la llamada del SDK marcada como roadmap.
Este ejemplo de pago cripto en JavaScript muestra un flujo que funciona hoy: el servidor crea el pago con la API v1 en vivo, el navegador se redirige a la página alojada y el webhook confirma el pedido. La llamada del Low-Code SDK al final es solo una vista previa de la hoja de ruta.
El flujo en cuatro pasos
El cliente pulsa pagar, tu servidor crea el pago, el navegador va al redirectUrl y el webhook confirma el estado final. Cada paso es una llamada HTTP normal o una redirección, así que el ejemplo no necesita ninguna librería especial.
La llamada del servidor en JavaScript
Un manejador en Node.js envía POST /api/v1/payment con la cabecera x-api-key, el id del pedido y el precio en USD, y devuelve al navegador el redirectUrl. La clave nunca sale del servidor.
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
}El lado del navegador
La página solo necesita un botón que llame a tu manejador y después siga el redirectUrl devuelto. En el navegador no hay clave ni lógica de importes.
El manejador del webhook
El endpoint del webhook lee id y status, comprueba la cabecera x-api-key y marca el pedido como pagado cuando el estado es paid. Hazlo seguro para repetirse, porque el mismo mensaje puede llegar dos veces.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }La llamada prevista del SDK
Se espera que el Low-Code SDK de la hoja de ruta abra el mismo flujo desde la página con una sola llamada. Es una vista previa de una API no publicada, mostrada solo como orientación, y no debe usarse en producción.
Prueba antes de salir en vivo
Crea una factura de demostración, págala en la página alojada y confirma que tu webhook recibe el estado final y marca el pedido.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });FAQ
¿Este ejemplo usa un SDK?
No. El flujo que funciona usa llamadas HTTP normales y una redirección. La llamada del SDK es solo una vista previa de la hoja de ruta.
¿Puedo usar la llamada QvardCheckout.open() en producción?
No. El SDK todavía no se ha publicado. Usa la API, el redirectUrl y el webhook.
¿Dónde debe estar la clave de API?
Solo en el servidor. El navegador recibe únicamente el redirectUrl.
¿Cómo sé que el pago está completo?
Solo cuando el webhook entrega el id y el estado paid.
