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

# Configuración por nivel

> Cómo definir los campos de configuración de cada método —credenciales y ajustes— por marca, tienda o dispositivo en PayBridge (account).

<Warning>
  **Próximamente.** PayBridge todavía no está disponible. Esta guía adelanta cómo va a funcionar; las pantallas que describe pueden no estar habilitadas aún en tu backoffice.
</Warning>

Además de decidir **dónde** está prendido un método ([Disponibilidad](/es/manuals/paybridge/availability)), en PayBridge defines **con qué datos** opera. Esos datos —credenciales, identificadores y demás campos— se guardan por nivel, se combinan de lo general a lo específico y son los que Fire mantiene **sincronizados con DSI** para que después cada cobro viaje liviano.

<Info>
  Los valores se combinan de lo general a lo específico: **General (método) → Marca → Tienda → Dispositivo**. El nivel más específico gana por cada clave; lo que un nivel no define lo hereda del de arriba.
</Info>

## Requisitos previos

* Acceso al backoffice de Fire en **[app.fire.rest](https://app.fire.rest)**, con permisos sobre la cuenta.
* País, cuenta y marca seleccionados en el selector de contexto.

## 1. Abre la pestaña Configuración

Entra a **PayBridge → Métodos de pago**, abre un método y ve a la pestaña **Configuración**. La pantalla es un master-detail: a la izquierda el árbol de niveles, a la derecha el objeto de configuración del nivel seleccionado.

<Frame>
  <img src="https://mintcdn.com/firepos/joKYklOan_08XfHw/images/manuals/paybridge/configuration/01-config-overview.png?fit=max&auto=format&n=joKYklOan_08XfHw&q=85&s=8aa9d63433d636b57713d0aebf1e6c8e" alt="Pestaña Configuración con árbol de niveles y objeto efectivo" width="1367" height="754" data-path="images/manuals/paybridge/configuration/01-config-overview.png" />
</Frame>

## 2. Elige un nivel

En el árbol de la izquierda selecciona el nivel que quieres ver o editar:

* **Marca** — aplica a todas las tiendas de la marca.
* **Tienda** — despliega la marca para ver sus tiendas.
* **Dispositivo** — despliega una tienda para ver sus terminales POS y kioscos.

Cada nivel muestra un contador con la cantidad de campos propios que tiene definidos.

<Frame>
  <img src="https://mintcdn.com/firepos/joKYklOan_08XfHw/images/manuals/paybridge/configuration/02-level-tree.png?fit=max&auto=format&n=joKYklOan_08XfHw&q=85&s=de2d62772eb76c8ce85b5276ce5018eb" alt="Árbol de niveles con contadores de campos por nivel" width="340" height="405" data-path="images/manuals/paybridge/configuration/02-level-tree.png" />
</Frame>

## 3. Lee el objeto efectivo

A la derecha se muestra el **objeto efectivo** del nivel seleccionado: sus campos propios más los que hereda de los niveles superiores. Hay dos vistas:

* **Cliente** — lista legible: cada campo indica de qué nivel proviene y, si sobrescribe a un nivel superior, lo señala.
* **Desarrollador** — el objeto JSON tal cual, listo para el runtime.

Usa el ícono del ojo para mostrar u ocultar los valores marcados como secretos.

<Frame>
  <img src="https://mintcdn.com/firepos/joKYklOan_08XfHw/images/manuals/paybridge/configuration/03-effective-object.png?fit=max&auto=format&n=joKYklOan_08XfHw&q=85&s=bbd84bfb495f7e45c098bc47d471c907" alt="Panel derecho con las vistas Cliente y Desarrollador del objeto efectivo" width="684" height="461" data-path="images/manuals/paybridge/configuration/03-effective-object.png" />
</Frame>

## 4. Agrega o edita campos

Haz clic en **Configurar campos…** para abrir el editor del nivel. Para cada campo defines:

* **Clave** — el identificador (por ejemplo `merchant_id`).
* **Tipo** — Texto, Número, Booleano o JSON.
* **Valor** — el contenido del campo.
* **Descripción** *(opcional)* — para qué sirve el campo.
* **Secreto** — si el valor debe mostrarse enmascarado (credenciales).

<Frame>
  <img src="https://mintcdn.com/firepos/joKYklOan_08XfHw/images/manuals/paybridge/configuration/04-field-editor.png?fit=max&auto=format&n=joKYklOan_08XfHw&q=85&s=b4f41c1a05f1ebd92a200d48d6d4d04d" alt="Editor de campos con clave, tipo, valor, descripción y switch secreto" width="1173" height="839" data-path="images/manuals/paybridge/configuration/04-field-editor.png" />
</Frame>

El panel de la derecha del editor muestra en vivo cómo queda la configuración efectiva antes de guardar.

## 5. Guarda

Haz clic en **Guardar cambios**. El sistema registra la fecha y el usuario que actualizó cada campo modificado. Los valores del nivel se reflejan de inmediato en el objeto efectivo.

<Frame>
  <img src="https://mintcdn.com/firepos/joKYklOan_08XfHw/images/manuals/paybridge/configuration/05-saved.png?fit=max&auto=format&n=joKYklOan_08XfHw&q=85&s=455528361db3e529e5dae9fe6ca7262e" alt="Configuración guardada con la marca de última actualización" width="426" height="78" data-path="images/manuals/paybridge/configuration/05-saved.png" />
</Frame>

## Cómo se usa esta configuración

PayBridge y DSI trabajan en **dos planos separados**:

1. **Plano de configuración.** Fire es la fuente de verdad y **sincroniza esta configuración hacia DSI** de forma anticipada: cuando cambias un campo, un método o un canal, Fire actualiza contra DSI la configuración del merchant (métodos habilitados, sucursales, terminales y credenciales). Así DSI ya conoce al merchant antes de cualquier cobro.
2. **Plano de transacción.** Al realizar un pago, como DSI ya tiene la configuración, el payload que envía Fire es **lean** (orden, monto, método, referencia). No hay que enriquecer la solicitud con estos campos en cada pago.

Por eso lo que definas aquí importa: es lo que Fire mantiene sincronizado con DSI para que los cobros sean simples y consistentes.

<Note>
  El objeto efectivo que ves a la derecha es justamente lo que se sincroniza para ese scope (marca, tienda o dispositivo).
</Note>

## Relacionado

<CardGroup cols={2}>
  <Card title="Disponibilidad de métodos" icon="table-cells" href="/es/manuals/paybridge/availability">
    Decide dónde está prendido el método y en qué canales.
  </Card>

  <Card title="Métodos soportados por país" icon="globe" href="/es/manuals/paybridge/supported-methods">
    Los métodos que PayBridge contempla en cada país.
  </Card>
</CardGroup>
