> ## 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.

# Configuração por nível

> Como definir os campos de configuração de cada método —credenciais e ajustes— por marca, loja ou dispositivo no PayBridge (conta).

<Warning>
  **Em breve.** O PayBridge ainda não está disponível. Este guia antecipa como vai funcionar; as telas que ele descreve podem ainda não estar habilitadas no seu backoffice.
</Warning>

Além de decidir **onde** um método está ligado ([Disponibilidade](/pt/manuals/paybridge/availability)), no PayBridge você define **com quais dados** ele opera. Esses dados —credenciais, identificadores e demais campos— são salvos por nível, combinados do geral ao específico, e são o que o Fire mantém **sincronizado com a DSI** para que depois cada cobrança viaje leve.

<Info>
  Os valores se combinam do geral ao específico: **Geral (método) → Marca → Loja → Dispositivo**. O nível mais específico vence por chave; o que um nível não define é herdado do de cima.
</Info>

## Pré-requisitos

* Acesso ao backoffice do Fire em **[app.fire.rest](https://app.fire.rest)**, com permissões sobre a conta.
* País, conta e marca selecionados no seletor de contexto.

## 1. Abra a aba Configuração

Vá em **PayBridge → Métodos de pagamento**, abra um método e vá até a aba **Configuração**. A tela é um master-detail: à esquerda a árvore de níveis, à direita o objeto de configuração do nível selecionado.

<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="Aba Configuração com árvore de níveis e objeto efetivo" width="1367" height="754" data-path="images/manuals/paybridge/configuration/01-config-overview.png" />
</Frame>

## 2. Escolha um nível

Na árvore à esquerda selecione o nível que deseja ver ou editar:

* **Marca** — vale para todas as lojas da marca.
* **Loja** — expanda a marca para ver suas lojas.
* **Dispositivo** — expanda uma loja para ver seus terminais POS e quiosques.

Cada nível mostra um contador com a quantidade de campos próprios 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="Árvore de níveis com contadores de campos por nível" width="340" height="405" data-path="images/manuals/paybridge/configuration/02-level-tree.png" />
</Frame>

## 3. Leia o objeto efetivo

À direita é exibido o **objeto efetivo** do nível selecionado: seus campos próprios mais os que herda dos níveis superiores. Há duas visões:

* **Cliente** — lista legível: cada campo indica de qual nível vem e, se sobrescreve um nível superior, sinaliza.
* **Desenvolvedor** — o objeto JSON como está, pronto para o runtime.

Use o ícone de olho para mostrar ou ocultar os 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="Painel direito com as visões Cliente e Desenvolvedor do objeto efetivo" width="684" height="461" data-path="images/manuals/paybridge/configuration/03-effective-object.png" />
</Frame>

## 4. Adicione ou edite campos

Clique em **Configurar campos…** para abrir o editor do nível. Para cada campo você define:

* **Chave** — o identificador (por exemplo `merchant_id`).
* **Tipo** — Texto, Número, Booleano ou JSON.
* **Valor** — o conteúdo do campo.
* **Descrição** *(opcional)* — para que serve o campo.
* **Secreto** — se o valor deve ser exibido mascarado (credenciais).

<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 com chave, tipo, valor, descrição e switch secreto" width="1173" height="839" data-path="images/manuals/paybridge/configuration/04-field-editor.png" />
</Frame>

O lado direito do editor mostra ao vivo como fica a configuração efetiva antes de salvar.

## 5. Salve

Clique em **Salvar alterações**. O sistema registra a data e o usuário que atualizou cada campo modificado. Os valores do nível são refletidos imediatamente no objeto efetivo.

<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="Configuração salva com a marca de última atualização" width="426" height="78" data-path="images/manuals/paybridge/configuration/05-saved.png" />
</Frame>

## Como esta configuração é usada

O PayBridge e a DSI trabalham em **dois planos separados**:

1. **Plano de configuração.** O Fire é a fonte de verdade e **sincroniza esta configuração com a DSI** de forma antecipada: quando você altera um campo, um método ou um canal, o Fire atualiza na DSI a configuração do merchant (métodos habilitados, lojas, terminais e credenciais). Assim a DSI já conhece o merchant antes de qualquer cobrança.
2. **Plano de transação.** Ao realizar um pagamento, como a DSI já tem a configuração, o payload que o Fire envia é **lean** (pedido, valor, método, referência). Não é preciso enriquecer a solicitação com esses campos a cada pagamento.

Por isso o que você define aqui importa: é o que o Fire mantém sincronizado com a DSI para que as cobranças sejam simples e consistentes.

<Note>
  O objeto efetivo que você vê à direita é exatamente o que é sincronizado para aquele escopo (marca, loja ou dispositivo).
</Note>

## Relacionado

<CardGroup cols={2}>
  <Card title="Disponibilidade de métodos" icon="table-cells" href="/pt/manuals/paybridge/availability">
    Decida onde o método está ligado e em quais canais.
  </Card>

  <Card title="Métodos suportados por país" icon="globe" href="/pt/manuals/paybridge/supported-methods">
    Os métodos que o PayBridge contempla em cada país.
  </Card>
</CardGroup>
