SDK JavaScript para checkout cripto: previsto y funcionando hoy
SDK JavaScript para checkout cripto explicado: un script previsto que abre la ventana de pago, qué está en la hoja de ruta de Qvard y qué funciona hoy.
Un SDK JavaScript para checkout cripto abriría una ventana de pago con unas pocas líneas de código en tu sitio. El Low-Code SDK de Qvard está en la hoja de ruta y todavía no se ha publicado. Esta guía explica la idea y muestra el flujo v1 real que puedes usar ahora.
Qué hace un SDK de checkout
Un SDK de checkout es una pequeña librería JavaScript que carga un sitio para iniciar un pago. Dibuja la ventana de pago, guía al cliente por los pasos y devuelve el estado a la página. La lógica del pedido se queda en el servidor del comercio.
Estado: el SDK está en la hoja de ruta
El Low-Code SDK de Qvard no se ha publicado, y este artículo no lo describe como librería terminada. El fragmento siguiente es una vista previa de la llamada prevista, no código que puedas ejecutar hoy.
Qué funciona hoy
Crea el pago en tu servidor con POST /api/v1/payment y la cabecera x-api-key, redirige al cliente al redirectUrl devuelto en la página de checkout alojada y recibe el estado final por webhook. Es el equivalente funcional de la llamada prevista del SDK.
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
Envía el id del pedido como id y el precio en USD como price. Guarda la clave de API en el servidor; el navegador solo recibe el redirectUrl que devuelve el servidor.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });La llamada prevista del SDK
Se espera que el SDK de la hoja de ruta abra el mismo flujo de pago desde la página con una sola llamada. El nombre del método y las opciones pueden cambiar antes de publicarse, así que no desarrolles contra la vista previa todavía.
Cómo prepararse
Mantén la creación del pago en una función del backend y el manejador de webhook por separado. Cuando salga el SDK solo cambiará la llamada del frontend; la llamada al servidor y el webhook seguirán igual.
FAQ
¿Hay hoy un SDK JavaScript de checkout de Qvard?
No. El Low-Code SDK está en la hoja de ruta. Hoy el mismo resultado se obtiene con la API, la página de checkout alojada y el webhook.
¿Puedo usar ya la llamada QvardCheckout.open()?
No. Se muestra solo como vista previa de la API prevista. Usa POST /api/v1/payment y redirige al redirectUrl.
¿Necesito una librería JavaScript para aceptar cripto hoy?
No. Basta un botón normal que llame a tu backend y redirija al redirectUrl; el webhook confirma el pago.
¿Cómo pruebo el flujo?
Crea una factura de demostración y comprueba que tu webhook recibe el estado final.
