Aceptar cripto sin redirección: checkout incrustado de Qvard
Acepta cripto sin redirección con el checkout incrustado de Qvard. Un widget JavaScript en tu página, dos formas de crear pagos y verificación de firma de webhook. Por qué es importante y cómo funciona.
Aceptar cripto sin redirección significa que el cliente paga sin salir de tu página. El checkout incrustado de Qvard hace exactamente eso: añade un script desde qvard.com/checkout.js, crea pagos vía API o navegador y maneja la firma del webhook. Esta guía te muestra cómo.
Por qué la redirección cuesta conversiones
Cada redirección es un momento en el que el cliente puede abandonar. Sale de la tienda, ve una página que no conoce y tiene que confiar en un sitio nuevo. Mantener el pago en tu página reduce esa fricción y ayuda a terminar el pedido.
Cómo funciona en Qvard
El checkout incrustado de Qvard está en directo y listo para usar. Añade el script https://qvard.com/checkout.js a tu página, crea un pago desde tu servidor o directamente en el navegador y abre el widget. La ventana de pago es una página de Qvard en iframe o popup: el cliente ve su idioma, elige un activo y una red, y paga. Visita https://qvard.com/en/embedded-checkout/playground/ para verlo en acción.
Dos formas de crear el pago
Por servidor (seguro): POST /api/v1/payment con tu clave secreta qvard_sk_... en el encabezado x-api-key; recibes id y redirectUrl. Por navegador (rápido): pasa tu clave pública qvard_pk_... al widget y deja que el cliente pague desde la página—su navegador envía el importe, así que verifica en el webhook. Si prefieres no incrustar, redirige a redirectUrl en la página alojada en su lugar; ese flujo también funciona.
X-Qvard-Signature: t=1760950000,v1=…
{ "id": "order_1024", "status": "paid" }Reduce la fricción alrededor de la redirección
Crea el pago solo cuando el cliente pulse pagar, no antes. Muestra el total y la moneda antes de redirigir, para que sepa qué verá en la página siguiente. El id del pedido y el total deben ser los mismos desde el carrito hasta el pago.
Verifica la firma del webhook
Cada webhook lleva un encabezado X-Qvard-Signature: firma el cuerpo del request con tu clave secreta usando HMAC-SHA256, formato t=<timestamp>,v1=<hex>. Verifica la firma, comprueba que la marca de tiempo es reciente (rechaza solicitudes antiguas), y solo entonces marca el pedido como pagado si el webhook confirma el id de pago y un estado de pagado. Luego envía la confirmación al cliente.
Cuándo elegir la ventana incrustada
Elige la ventana incrustada cuando tu embudo pierda clientes en la redirección. El widget los mantiene en tu página mientras pagan. El cliente elige un activo y una red; la ventana confirma los importes y detalles, así que sabe exactamente qué esperar.
FAQ
¿Puede Qvard aceptar cripto sin redirección hoy?
Sí. Usa el widget de checkout incrustado desde qvard.com/checkout.js para mantener la ventana de pago en tu página. El cliente paga sin irarse, y tú manejas el webhook para confirmar el pago.
¿La redirección reduce la conversión?
Puede, porque los clientes pueden irse por el camino. El widget incrustado lo resuelve manteniéndolo en tu página y mostrándole su idioma e importes finales de entrada.
¿Qué necesito para incrustar el widget?
Añade el script https://qvard.com/checkout.js, crea un pago vía API o navegador, y escucha los eventos onSuccess, onClose u onError. El webhook confirma el pago una vez que el cliente paga.
¿Es seguro poner la clave pública en el navegador?
Sí, la clave pública qvard_pk_... está hecha para el navegador. Establece límites sobre qué sitios web pueden usarla en tu panel de control. Pero siempre verifica el importe en el webhook porque el importe en el navegador puede cambiarse.
