Antes de consumir cualquier endpoint de la API de Forpay, es obligatorio autenticarse. Todas las operaciones requieren un token de autorización válido, el cual se obtiene mediante el endpoint/login.

La autenticación se realiza enviando como parámetro obligatorio una password en formato JWE (JSON Web Encryption). Este valor corresponde a una credencial cifrada, generada previamente según el estándar JWE.

Como respuesta, el servicio retorna un JWT (JSON Web Token). Este token debe ser incluido en el header Authorization de todas las solicitudes posteriores a la API, permitiendo así la ejecución de las operaciones autorizadas mientras el token se encuentre vigente.

Validez del token

El token de autenticación tiene una vigencia limitada de 30 minutos y es exclusivo para la empresa con la cual se realiza el proceso de login.

Una vez expirado, será necesario obtener un nuevo token mediante el endpoint /login. Se recomienda almacenar y reutilizar el token durante su período de validez para todas las solicitudes posteriores, ya que la cantidad de tokens de login simultáneos es limitada. Esto evita generar un nuevo token en cada petición y reduce el riesgo de bloqueos o errores por exceso de autenticaciones.