¿Qué es una pasarela host-to-host de pagos?
Qué es una pasarela host-to-host de pagos: pagos servidor a servidor con redirección a la página alojada y webhook final, explicado para comercios.
Una pasarela host-to-host de pagos conecta tu servidor directamente con el proveedor de pagos. Tu backend crea los pagos, el cliente paga en una página alojada y el proveedor devuelve el resultado a tu servidor.
Qué significa host-to-host
En el modelo host-to-host la solicitud de pago va de tu servidor a la pasarela, no desde el navegador. El cliente solo se encuentra con la pasarela en la página de pago alojada, y las claves y la lógica del pedido quedan de tu lado.
Cómo funciona el flujo
Tu servidor crea un pago con POST /api/v1/payment, recibe un redirectUrl, envía allí al cliente y recibe el estado final por webhook. Tres pasos cubren todo el flujo.
Para quién es
Tiendas online, productos SaaS y marketplaces que ya tienen un backend y quieren control total de la lógica del checkout, de los estados de pedido y de la conciliación.
Página alojada y tipo de cambio fijo
El cliente paga en el checkout alojado de Qvard, que muestra el importe exacto del activo y la red elegidos a un tipo de cambio fijo durante la vida de la factura. No tienes que generar direcciones ni lógica de tipos de cambio.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR",
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Lo básico de seguridad
Guarda x-api-key en el servidor, comprueba la cabecera x-api-key en cada webhook y acepta solo endpoints HTTPS. Trata la redirección como navegación, no como confirmación de pago.
Cuándo encaja mejor otro producto
Sin backend, un enlace de pago es más sencillo. El checkout integrado, el SDK, el terminal y el checkout de Telegram están en la hoja de ruta; hoy el mismo resultado se consigue con la API y la página alojada.
FAQ
¿Host-to-host es lo mismo que una API?
Es un modelo basado en API en el que el servidor habla directamente con la pasarela. El término describe quién hace la llamada, el servidor, no un protocolo distinto.
¿Necesito un servidor dedicado?
No. Basta cualquier backend que pueda hacer solicitudes HTTPS y exponer una URL de webhook.
¿Cuánto cuesta la pasarela?
La tarifa base es del 1% por pago, las tarifas individuales bajan hasta el 0,1% con el volumen y las comisiones de red se pagan aparte.
¿Puedo combinar host-to-host con la página alojada?
Sí, ese es el flujo estándar: la API crea el pago y la página alojada lo cobra.
