Checkout alojado o checkout propio para pagos cripto
Checkout alojado o propio para pagos cripto: qué significa cada uno, por qué Qvard usa una página alojada, qué puedes diseñar tú y cuándo conviene esperar un checkout propio.
Todo servicio de pagos enfrenta la misma decisión de diseño: ¿los clientes pagan en una página que aloja el proveedor o dentro de un checkout que construyes tú? Para la cripto la segunda opción es mucho más pesada que para las tarjetas. Esta guía explica la diferencia, por qué Qvard ofrece hoy una página alojada, qué puedes seguir personalizando a su alrededor y qué tendría que existir para que un checkout totalmente propio tuviera sentido.
Dos formas de cobrar un pago
- Checkout alojado. Creas un pago y envías al cliente a una página que gestiona el proveedor. El proveedor muestra la dirección, el monto exacto y el estado; tú recibes el resultado por notificación.
- Checkout propio. El formulario de pago vive dentro de tu propio sitio o aplicación. Tú muestras los datos del pago, sigues el estado y gestionas cada situación a la que pueda llegar el cliente.
El checkout alojado se lanza más rápido y conlleva menos riesgo. El propio da control total del aspecto y del flujo, a cambio de construir y mantener todo lo que la página alojada hace por ti.
Qué tiene que hacer un checkout cripto
Un checkout con tarjeta básicamente recoge unos pocos campos y llama a una API. Un checkout cripto tiene más tareas:
- mostrar una dirección de pago para el activo y la red elegidos, con la red junto a ella;
- mostrar un monto exacto, fijado el tiempo suficiente para que el cliente lo envíe;
- dejar que el cliente elija un activo y una red, y explicar la diferencia;
- seguir el pago en la blockchain, incluidos los pagos insuficientes y los tardíos;
- gestionar errores como la red equivocada, con un mensaje claro.
En cada uno de estos puntos un error le cuesta dinero al cliente. Es el argumento más fuerte a favor de una página alojada.
Por qué Qvard funciona hoy con una página alojada
El flujo de pago de Qvard está construido en torno a la página alojada. Creas un pago con un único POST a https://api.qvard.com/api/v1/payment, y la respuesta contiene un redirectUrl, la dirección de esa página. El cliente elige allí el activo y la red, ve la dirección y el monto exacto y paga; el tipo de cambio queda fijado durante una hora. Consulta cómo funciona redirectUrl en el checkout cripto.
La API pública es pequeña: crea un pago, comprueba si un método de pago está listo y envía un pago saliente. No te entrega una dirección de depósito para mostrarla tú, y no tiene ninguna ruta para leer el estado de un pago, así que no podrías seguir un pago desde tu propia página. El checkout incrustado está listo, y los SDK también; esta API todavía no admite un checkout cripto totalmente propio, con tu propia dirección y sondeo de estado.
Qué puedes seguir diseñando tú
La página alojada hace la parte difícil. La experiencia a su alrededor es tuya:
- El paso previo. La opción «Pagar con cripto», la explicación de lo que va a pasar, las comisiones y la regla de reembolso, con tus palabras y tu diseño.
- El paso posterior. Una página de pedido que muestra el estado real (en espera, insuficiente, pagado), se actualiza mientras espera e indica al cliente qué hacer después. Todavía no hay URL de retorno, así que el cliente vuelve a tu sitio a través de esta página.
- Mensajes. El correo que envías cuando se crea el pedido, se paga o el pago queda incompleto.
- Lógica de negocio. Qué estados liberan mercancía, qué haces con un pago insuficiente, cómo reembolsas.
Bien hecho, el cliente ve una tienda coherente con una página de pago en medio, y eso es lo que necesitan la mayoría de los comerciantes.
Cómo elegir
- Elige el checkout alojado si quieres lanzar pronto, si tu equipo es pequeño, si no quieres ser responsable de los casos extremos de la blockchain, o si simplemente necesitas que funcione. Es lo que Qvard admite hoy.
- Usa el checkout incrustado si una experiencia fluida dentro de la página es esencial para tu producto. Su lógica de factura coincide con la página alojada, así que la lógica de pedidos, el webhook y la página de pedido pasan sin cambios.
- No construyas tu propia generación y escaneo de direcciones para obtener un aspecto propio. Es la forma más pesada y arriesgada de comprar un diseño.
Elijas lo que elijas, la parte del servidor es la misma: crear un pago con tu número de pedido como id, marcar el pedido como pagado solo desde el webhook (exactamente HTTP 200, seguro si se ejecuta dos veces) y conciliar. Consulta cómo aceptar pagos cripto en un sitio web y API de pagos cripto para desarrolladores. Una factura de demostración muestra la página alojada.
FAQ
¿Puedo incrustar el formulario de pago de Qvard en mi propia página?
Sí. El checkout incrustado abre la ventana de pago de Qvard sobre tu página, como modal o como bloque integrado. La página de pago alojada sigue disponible.
¿Puedo mostrar la dirección de pago en mi propia página?
La API no devuelve una dirección de depósito para que la muestres, y no tiene ninguna ruta para leer el estado del pago, así que la dirección y el estado viven en la página alojada.
¿Qué puedo personalizar?
Los pasos previo y posterior a la página de pago: la opción en el checkout, las explicaciones, la página de estado del pedido y tus correos, además de tu propia lógica de negocio.
¿Pasar más adelante a un checkout incrustado romperá mi integración?
Cuenta con que la parte del servidor siga igual: crear el pago con tu id de pedido, marcar los pedidos como pagados desde el webhook y conciliar. Solo cambiaría la parte de front-end alrededor del pago.
