El Merchant gobierna el terminal

Un terminal que solo sabe cobrar es una isla: si falla, nadie se entera hasta que el comercio llama. Los equipos Android de FINORA llevan un agente que los mantiene conectados al Merchant. Desde la consola o desde el portal del comercio se puede ver cómo está cada equipo y darle instrucciones a distancia. Esa administración remota es lo que se llama TMS.

Las tres tareas del agente

El agente corre en segundo plano, con una notificación permanente «Terminal conectado a FINORA», y hace tres cosas a la vez:

Tarea	Qué hace
Escuchar cobros	Espera órdenes de cobro enviadas por el sistema del comercio. Ver Cobro empujado
Escuchar comandos	Espera instrucciones administrativas del Merchant y las ejecuta
Latir	Cada 60 segundos, al arrancar y después de cada comando, le cuenta al Merchant cómo está

Las dos escuchas usan sondeo largo (long-poll): el equipo hace una petición y el Merchant la mantiene abierta hasta que tiene algo que entregar o pasan unos segundos. No hace falta ninguna infraestructura de notificaciones push, lo que importa en equipos sin los servicios de Google.

El latido

Cada latido lleva la telemetría del equipo: versión de la aplicación, batería y si está cargando, tipo de red y señal wifi, modelo y versión de Android, si está escuchando cobros, la hora del último cobro y, solo si el permiso ya estaba concedido, la última ubicación conocida. La respuesta del Merchant trae dos cosas:

• el estado operativo que debe tener el equipo (activo, suspendido o bloqueado);
• la versión de parámetros vigente. Si no coincide con la del equipo, el agente descarga los parámetros nuevos: datos del comercio, medios de pago aceptados, tiempos de espera.

Los comandos

Comando	Qué hace
Estado	Responde la telemetría ahora mismo
Parámetros	Descarga y aplica los parámetros vigentes
Activar / Desactivar	Quita o pone la pantalla de bloqueo operativo
Abrir la aplicación	La trae al frente y, si se pide, abre una pantalla concreta (venta, cierre, historial, ajustes…)
Cerrar el lote	El mismo cierre que el botón del cajero
Reiniciar la aplicación	La vuelve a abrir con la pila limpia
Mensaje	Muestra un aviso al operador, que espera hasta que lo cierre

Cada comando se marca como iniciado, se ejecuta con un techo de dos minutos y se reporta con su resultado. Un comando vencido no se ejecuta.

La regla de oro

Con un cobro en curso, el agente no navega, no cierra el lote y no reinicia. Sacar al cliente de la pantalla de pago mientras pone su tarjeta es exactamente lo que no puede pasar: el comando responde «terminal ocupado».

Los comandos que mueven dinero (cobrar y reembolsar) no viajan por este canal, sino por el de órdenes de cobro, con su idempotencia y su EN_DUDA.

La pantalla de bloqueo operativo

Cuando el comercio o el adquirente suspende un terminal, el equipo muestra una pantalla «Terminal suspendido» por encima de todo. No hay botón de atrás ni atajo que la esquive.

Entra por	Sale por
El comando Desactivar	El comando Activar
Un latido que dice «suspendido» o «bloqueado», aunque el comando no haya llegado	Un latido que dice «activo»
El estado guardado: un equipo suspendido que se reinicia arranca suspendido	—

La clave de administrador del equipo levanta la pantalla para entrar a ajustes y diagnosticar, pero no cambia el estado: el Merchant sigue rechazando las ventas de ese terminal. Y un latido sin estado, o con un valor desconocido, conserva el estado actual: un servidor viejo no puede desbloquear por accidente un equipo suspendido.

Lo que todavía no hace

Instalar o actualizar aplicaciones en silencio, reiniciar el equipo completo y abrir aplicaciones de terceros exigen que FINORA sea propietario del dispositivo o tenga la firma del fabricante. Están en la hoja de ruta, igual que las llaves reales del terminal.

Lo que necesitas recordar

• El agente escucha cobros, escucha comandos y late cada 60 segundos.
• Los parámetros se actualizan solos cuando cambia su versión.
• Suspender un terminal lo bloquea aunque el comando se pierda: basta el siguiente latido.