Saltar al contenido principal
Migo Docs

Webview hospedado

El webview hospedado de Migo es una UI de checkout autocontenida servida en la URL devuelta al crear una transacción (consulta Crear un Payment Link). El comercio solo necesita entregar esa URL al cliente — el webview maneja todo el flujo de pago del lado de Migo.

El integrador solo crea la transacción

Por API haces una única llamada: crear la transacción/payment link. Todo lo descrito a continuación — cargar el checkout, capturar los datos de tarjeta, seleccionar cuotas, 3D Secure, cobrar y el redirect final — sucede dentro del webview hospedado de Migo. Nunca recolectas datos de tarjeta, nunca tokenizas y nunca llamas tú mismo a un endpoint de cobro.

Qué experimenta el cliente​

entregar URL ──► el cliente abre el webview hospedado ──► paga ──► redirect al comercio
                  │                                          │
                  │  1. el webview carga la config           │  ingresa tarjeta · elige
                  │     y los métodos de pago de tu cuenta   │  cuotas · 3D Secure
                  │                                          │  · confirma
                  └──────────────────────────────────────────┘

1. El webview carga tu checkout​

Cuando el cliente abre la URL, el webview resuelve la configuración de tu cuenta de comercio y renderiza el checkout automáticamente. Aplica:

  • URLs de retorno — a dónde se envía al cliente de vuelta a tu sitio tras el pago, con el resultado codificado en query params (uid, status, reference).
  • Métodos de pago habilitados — los métodos de pago (procesadores de tarjeta y rieles) habilitados para tu cuenta de comercio, usados para renderizar el selector de método.
  • Branding — tu logo y color primario para la personalización visual.

Migo personaliza las URLs de retorno para que ya lleven identificadores de la transacción como el uid, su status y la reference legible.

2. Configuración por método​

Para cada método de pago habilitado, el webview renderiza la UI específica del método, incluyendo:

  • Marcas de tarjeta y rangos de BIN aceptados
  • Opciones de cuotas
  • Cualquier campo adicional requerido (por ejemplo, tipo / id de documento para ciertos rieles)

3. Campos extra opcionales​

Si tu cuenta de comercio requiere campos extra (dirección de envío, número de documento), el webview los captura y los anexa al additionalData de la transacción, donde quedan disponibles para el método de pago y para la notificación saliente al comercio.

4. Ingreso de tarjeta, cuotas y cobro​

Dentro del webview el cliente ingresa los datos de su tarjeta, elige el número de cuotas (cuando el método lo soporta) y confirma. Migo luego tokeniza la tarjeta y cobra la transacción contra el método de pago seleccionado para tu cuenta de comercio — todo internamente. El flujo de cara al cliente es idéntico sin importar qué método de pago se use finalmente.

5. 3D Secure​

Si el método de pago requiere 3D Secure, el webview presenta el challenge al cliente, recopila la respuesta y completa la autenticación antes de finalizar el cobro — sin que intervenga ninguna acción del integrador.

6. Cierre del webview​

Tras un cobro exitoso — o cuando el cliente cierra el checkout — Migo redirecciona el navegador de vuelta a tu URL de retorno con el resultado codificado en query params. Tu sitio lee esos parámetros para actualizar el estado de cara al cliente.

Recibir el resultado autoritativo​

El redirect del navegador es para la experiencia del cliente; no es tu fuente de verdad. El resultado autoritativo se entrega a tu backend una vez que la transacción alcanza un estado terminal, vía el Merchant Generic Callback. Concilia contra ese callback, correlacionando con el uid de la transacción que recibiste al crear el link.

Relacionado​