Configurar FINORA Pago con un archivo

Cuando son decenas de equipos, nadie quiere pasar el asistente uno por uno. FINORA Pago lee su configuración de un archivo por máquina que tu herramienta de despliegue puede escribir.

Dónde va y cómo se lee

• Archivo: %ProgramData%\FINORA\finora-pago.conf. Es por máquina y existe antes de que el usuario de caja inicie sesión.
• Formato: CLAVE=valor, una por línea. Las líneas que empiezan con # o ; son comentarios.
• Las claves son las mismas que las variables de entorno (PAGO_MERCHANT_URL, PAGO_RIF…). La plantilla con todas, sus valores admitidos y su explicación viene con la instalación, en la carpeta resources\herramientas, como finora-pago.conf.example.
• Se lee al arrancar, cuando FINORA Merchant envía nuevos parámetros y cuando alguien pulsa Recargar .conf en Configuración.

Quién gana cuando dos fuentes dicen cosas distintas:

variables de entorno  >  FINORA Merchant  >  finora-pago.conf  >  pantalla de Configuración  >  valor por defecto

Lo que fija el archivo aparece en Configuración como «fijado por IT» y no se puede cambiar desde la pantalla.

Los pasos

1. Despliega el instalador en modo silencioso: FINORA-Pago-<versión>-win-x64.exe /S. Se instala por usuario.

2. Copia la plantilla y escribe al menos la conexión:

   PAGO_MERCHANT_URL=<URL_DEL_SERVIDOR_MERCHANT>
   PAGO_RIF=<RIF_DEL_COMERCIO>
   PAGO_TERMINAL_ID=<TID_DE_ESTA_INSTALACION>
   PAGO_TERMINAL_REMOTO=<TID_DEL_TERMINAL_DE_TARJETA>
   PAGO_API_KEY=<TU_CLAVE_API>
   PAGO_MODO_VENTANA=INMERSIVO

3. Guárdalo en %ProgramData%\FINORA\finora-pago.conf con tu herramienta (GPO, Intune, PDQ o la imagen del equipo).

4. Si quieres los eventos en el Visor de eventos de Windows, ejecuta una vez, como administrador, registrar-eventos.cmd de la misma carpeta de herramientas.

5. En el primer inicio de sesión del usuario de caja, FINORA Pago lee el archivo, guarda la clave cifrada y se registra en FINORA Merchant con el identificador de la instalación. Si falta algo, abre el asistente en el paso que falta.

6. Comprueba que la línea de la clave quedó convertida en comentario (# PAGO_API_KEY=(retirada a la bóveda…)). Si no, bórrala tú: ver abajo.

Los secretos, una sola vez

PAGO_API_KEY, PAGO_TOKEN_LOCAL y PAGO_PIN_INICIAL se leen solo en el primer arranque. FINORA Pago los cifra con el usuario de Windows, los guarda y reescribe su línea del archivo como comentario, para que el secreto no quede en claro.

Si la aplicación no tiene permiso para reescribir el archivo, lo avisa (evento 190) y TI debe borrar la línea al terminar el despliegue. Para rotar un secreto, escríbelo de nuevo en el archivo: al ver un valor distinto, la aplicación lo vuelve a importar.

Un valor inválido detiene el arranque

Una clave que FINORA Pago no conoce solo genera un aviso. Pero un valor no admitido en una clave conocida (por ejemplo, PAGO_MODO_VENTANA=KIOSCO) impide arrancar y muestra un diálogo con el archivo, la línea y cómo corregirlo. Es a propósito: un error de despliegue se dice, no se ignora.

Claves más usadas

Grupo	Claves
Conexión	PAGO_MERCHANT_URL, PAGO_RIF, PAGO_TERMINAL_ID (esta instalación), PAGO_TERMINAL_REMOTO (el terminal que recibe la tarjeta)
Secretos de primer arranque	PAGO_API_KEY, PAGO_TOKEN_LOCAL, PAGO_PIN_INICIAL
Ventana de pago	PAGO_MOSTRAR, PAGO_MODO_VENTANA, PAGO_MONITOR, PAGO_VENTANA_CAJERO, PAGO_CIERRE_SEGUNDOS, PAGO_SONIDOS, PAGO_REPOSO, PAGO_COLOR_COMERCIO, PAGO_LOGO_COMERCIO, PAGO_TAGLINE
API local	PAGO_PUERTO, PAGO_SANDBOX, PAGO_CORS_ORIGENES
Equipo	PAGO_PROXY, PAGO_ARRANCAR_CON_WINDOWS, PAGO_ACTUALIZACIONES_CANAL, PAGO_ACTUALIZACIONES_AUTO
Gobierno	TMS_ADMINISTRADO=NO para recibir los parámetros de FINORA Merchant sin aplicarlos

FINORA Merchant solo administra las claves de la ventana, del cobro y de la marca. Las de arranque (servidor, proxy, puerto, actualizaciones) son siempre del archivo, porque sin ellas la aplicación no llega al servidor.