Paso 3 · Lanzar el sistema

Una vez que tienes un access_token válido del login, abres el sistema de afiliados cargando su URL de lanzamiento con el token adjunto. Lo incrustas dentro de tu plataforma mediante un iframe (o el equivalente en tu stack), de modo que el sistema de afiliados aparece directamente dentro de tu producto.

La URL de lanzamiento

Carga el sistema de afiliados solicitando esta URL con el access token como el parámetro de consulta t:

GET https://<affiliate_system_host>/?t=<access_token>

• <affiliate_system_host> es el host del sistema de afiliados. Nosotros te proporcionamos el host real — para staging y para producción — junto con tus credenciales; no se publica aquí.
• t es el access_token que devuelve el endpoint de login.

Incrústalo en tu plataforma con un iframe cuyo src sea esa URL:

<iframe
    src="https://<affiliate_system_host>/?t=<access_token>"
    width="100%"
    height="800"
    frameborder="0"
></iframe>

El access_token es de corta duración (unos 15 minutos — consulta Login), así que genera un token nuevo justo antes de lanzar y construye la URL con él cada vez, en lugar de reutilizar uno antiguo.

Un 403 al lanzar significa que tu iframe aún no está habilitado

Hasta que habilitemos tu iframe, cargar la URL de lanzamiento devuelve 403. Esto es esperado y correcto — significa que tu lanzamiento aún no está habilitado, no que algo esté roto.

Tu login sigue funcionando todo el tiempo y devuelve un token válido durante todo el proceso; solo el lanzamiento está bloqueado. Una vez que pasas todos los escenarios del Simulador de Webhooks y nos avisas, habilitamos tu lanzamiento y el sistema carga normalmente (devuelve 200).

Consulta el Resumen de la integración para el orden completo, y el Simulador de Webhooks para los escenarios que debes pasar.

Solución de problemas

• Recibes un 403. Primero revisa si tu iframe ya fue habilitado — esta es la causa más común. Hasta que pases el Simulador de Webhooks y lo habilitemos, el lanzamiento permanece bloqueado y devuelve 403 por diseño.
• El sistema no carga y tu token podría estar viejo. El access_token expira después de unos 15 minutos. Solicita un token nuevo desde el login y reconstruye la URL de lanzamiento con él.