> ## Documentation Index
> Fetch the complete documentation index at: https://firespark.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar un dispositivo

> Datos de pago por kiosco: direcciones del terminal, ids y bridges locales.

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:

```json theme={null}
{
  "disabled_payment_ids": [],
  "payment_settings": {
    "pay-pinpad-downtown": {
      "terminal_ip": "192.168.1.40",
      "terminal_id": "TID00123"
    }
  }
}
```

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](https://firespark.cloud/docs/es/integrations-api/kiosk/devices/put.md) 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](https://firespark.cloud/docs/es/guides/monitoring-alerts.md) como fallas de terminal, con el id del dispositivo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.