Encrypt Password

Qué hace

Herramienta de desarrollo que genera un JWE compacto a partir de una contraseña de prueba y la llave pública Forpay del ambiente de desarrollo.

Cuándo usarlo

Se utiliza exclusivamente en desarrollo para preparar el valor password de una prueba de POST /login. En una integración productiva, genera el JWE en el backend de tu sistema siguiendo la guía de autenticación.

Endpoint

POST /jwe/encrypt

Solo para el ambiente de desarrollo. Configura FORPAY_BASE_URL con la base de desarrollo indicada en URL base y rutas. Usa las credenciales, llave pública y API key de ese ambiente.

Autenticación

Requiere x-api-key. No requiere JWT porque justamente se usa antes del login.

Headers requeridos

• country obligatorio con valor CL.
• commerce obligatorio, de 5 a 30 caracteres, con el identificador de comercio asignado.
• channel obligatorio, de al menos 3 caracteres, con el canal autorizado.
• requestDateTime obligatorio, con fecha y hora en formato ISO 8601.
• correlationId obligatorio, de al menos un carácter. Se recomienda un UUID para trazabilidad.
• processId: obligatorio. Para el flujo de nuevas integraciones documentado en esta guía, utiliza HYBRID.
• salesExecutiveId obligatorio, de al menos un carácter.
• x-api-key correspondiente al ambiente y al plan de consumo asignado.

Identificadores soportados

No usa identificadores de usuario o mandato. Usa commerce en headers para contextualizar el comercio.

Body / Parámetros

password es la contraseña original. publicKey es la llave pública Forpay entregada para el ambiente.

Reglas de negocio

• No uses este helper como dependencia productiva; en producción el cliente debe implementar la encriptación JWE en su backend.
• Nunca registres la contraseña en logs ni la compartas en tickets.

Respuesta exitosa

Devuelve payload.token, que corresponde al JWE compacto a enviar como password en POST /login.

Errores comunes

• 400: validación de headers, path, query o body.
• 403: credenciales, API key o JWT inválidos/no autorizados.
• 404: recurso no encontrado cuando aplica.

Notas de integración

• Mantén correlationId único por intento para trazabilidad.
• No reutilices ejemplos con datos reales en producción; reemplaza placeholders por valores del comercio.

Ejemplo recomendado

Usa el ejemplo incluido en el body del request como plantilla inicial y reemplaza los placeholders {{...}} o <...>.