Paso 1 · Login

El login es lo primero que puedes hacer, y funciona en cuanto tienes tus credenciales de staging. Tu backend se autentica y recibe un access token, que luego usas para lanzar el sistema de afiliados.

El login no está bloqueado: devuelve un token válido de inmediato, incluso antes de que tu integración esté completa. Abrir el sistema de afiliados (el iframe) es un paso aparte que permanece bloqueado hasta que pases el Simulador de Webhooks y lo habilitemos — consulta el Resumen de la integración para el orden completo.

El endpoint

POST {monolith_base_url}/api/v4/affiliates/login/
Content-Type: application/json

Cuerpo de la solicitud:

{
    "username": "<affiliate_username>",
    "password": "<affiliate_password>",
    "affiliate_point_of_sale_id": 2
}

Campo	Tipo	Descripción
username	string	El usuario de las credenciales que te entregamos.
password	string	La contraseña de las credenciales que te entregamos.
affiliate_point_of_sale_id	integer	El identificador del punto de venta para el login.

Respuesta de éxito

En caso de éxito recibes 201 Created con el access token:

{
    "status": 201,
    "access_token": "<JWT>"
}

El access_token es un JWT válido por unos 15 minutos. Cuando expira, simplemente vuelve a llamar al endpoint de login para obtener uno nuevo — no hay un endpoint de refresh. Como el token es de corta duración, solicita uno nuevo cuando lo necesites, por ejemplo justo antes de lanzar el sistema.

Errores

Si el affiliate_point_of_sale_id que envías no existe o no está asignado a tu cliente, recibes 404 Not Found:

{
    "status": 404,
    "message": "El Punto de Venta no existe o no esta asignada al cliente enviado. Favor de contactar al administrador del sistema.[1018]"
}

Este mensaje lo devuelve la API exactamente como se muestra. Significa que el affiliate_point_of_sale_id de tu solicitud no pudo asociarse a un punto de venta asignado a tu cliente. Verifica que estás enviando el affiliate_point_of_sale_id que te entregamos con tus credenciales; si sigue fallando, contáctanos.

Siguiente paso

Usa el access_token de un login exitoso para lanzar el sistema de afiliados. Consulta Paso 3 · Lanzar el sistema para ver cómo se usa el token.