Skip to main content
Los métodos de tarjeta presente necesitan datos que cambian de un kiosco a otro: la IP del terminal, su id de terminal o la dirección de un bridge local. Fire spark los guarda por dispositivo, separados de las credenciales del merchant.

​
Dónde se guardan

Cada kiosco tiene settings_overrides.payment_settings, con una entrada por id de pago:
Los campos que pide cada método están en su página, en Activarlo. Un campo secreto se devuelve enmascarado como ********. Si mandas ******** de vuelta se conserva el valor guardado, así puedes editar otros campos sin volver a escribir los secretos.

​
Cargar los valores

Envía settings_overrides.payment_settings con el endpoint Actualizar dispositivo de kiosco de la Integrations API. Las demás claves de settings_overrides conservan sus valores. La pantalla Devices del dashboard mostrará estos campos cuando haya disponible un método que los necesite.

​
Revisar antes de cobrar

En el canal, order.getMissingPaymentFields(payment) devuelve los campos requeridos que siguen vacíos en este dispositivo. Oculta el método o muestra un mensaje de configuración hasta que la lista esté vacía.

​
Bridges locales

Algunos terminales se alcanzan a través de un servicio bridge que corre en el dispositivo o en la red de la tienda. Lo instala y lo mantiene corriendo el equipo de operaciones de la tienda. Si el bridge usa http sin TLS, las apps Android deben permitir tráfico sin cifrar hacia él. La página de cada método dice si usa bridge.

​
Probar el terminal

Desde la pantalla de administración del kiosco, corre order.runPaymentTerminal(payment, "test") para revisar que el terminal o el bridge responda. Las fallas aparecen en las alertas de monitoreo como fallas de terminal, con el id del dispositivo.