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

# Configuration by level

> How to define each method's configuration fields —credentials and settings— by brand, store, or device in PayBridge (account).

<Warning>
  **Coming soon.** PayBridge is not available yet. This guide previews how it will work; the screens it describes may not be enabled in your backoffice yet.
</Warning>

Beyond deciding **where** a method is turned on ([Availability](/en/manuals/paybridge/availability)), in PayBridge you define **what data** it operates with. That data —credentials, identifiers, and other fields— is stored per level, combined from general to specific, and is what Fire keeps **synced to DSI** so that each charge can then travel lean.

<Info>
  Values combine from general to specific: **General (method) → Brand → Store → Device**. The most specific level wins per key; whatever a level doesn't define is inherited from the one above.
</Info>

## Prerequisites

* Backoffice access at **[app.fire.rest](https://app.fire.rest)**, with permissions on the account.
* Country, account, and brand selected in the context switcher.

## 1. Open the Configuration tab

Go to **PayBridge → Payment methods**, open a method, and go to the **Configuration** tab. The screen is a master-detail: the level tree on the left, the selected level's configuration object on the right.

<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="Configuration tab with level tree and effective object" width="1367" height="754" data-path="images/manuals/paybridge/configuration/01-config-overview.png" />
</Frame>

## 2. Pick a level

In the tree on the left, select the level you want to view or edit:

* **Brand** — applies to all of the brand's stores.
* **Store** — expand the brand to see its stores.
* **Device** — expand a store to see its POS terminals and kiosks.

Each level shows a counter with the number of fields defined at that level.

<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="Level tree with per-level field counters" width="340" height="405" data-path="images/manuals/paybridge/configuration/02-level-tree.png" />
</Frame>

## 3. Read the effective object

On the right you see the selected level's **effective object**: its own fields plus those inherited from higher levels. There are two views:

* **Client** — a readable list: each field shows which level it comes from and, if it overrides a higher level, flags it.
* **Developer** — the JSON object as-is, ready for the runtime.

Use the eye icon to show or hide values marked as secret.

<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="Right panel with the Client and Developer views of the effective object" width="684" height="461" data-path="images/manuals/paybridge/configuration/03-effective-object.png" />
</Frame>

## 4. Add or edit fields

Click **Configure fields…** to open the level's editor. For each field you define:

* **Key** — the identifier (for example `merchant_id`).
* **Type** — Text, Number, Boolean, or JSON.
* **Value** — the field's content.
* **Description** *(optional)* — what the field is for.
* **Secret** — whether the value should be shown masked (credentials).

<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="Field editor with key, type, value, description, and secret switch" width="1173" height="839" data-path="images/manuals/paybridge/configuration/04-field-editor.png" />
</Frame>

The right side of the editor shows live how the effective configuration looks before saving.

## 5. Save

Click **Save changes**. The system records the date and the user who updated each modified field. The level's values are reflected immediately in the effective object.

<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="Configuration saved with the last-updated stamp" width="426" height="78" data-path="images/manuals/paybridge/configuration/05-saved.png" />
</Frame>

## How this configuration is used

PayBridge and DSI work across **two separate planes**:

1. **Configuration plane.** Fire is the source of truth and **syncs this configuration to DSI** ahead of time: when you change a field, method, or channel, Fire updates the merchant's configuration on DSI (enabled methods, branches, terminals, and credentials). This way DSI already knows the merchant before any charge.
2. **Transaction plane.** When a payment is made, since DSI already has the configuration, the payload Fire sends is **lean** (order, amount, method, reference). There's no need to enrich the request with these fields on every payment.

That's why what you define here matters: it's what Fire keeps in sync with DSI so charges stay simple and consistent.

<Note>
  The effective object you see on the right is exactly what gets synced for that scope (brand, store, or device).
</Note>

## Related

<CardGroup cols={2}>
  <Card title="Method availability" icon="table-cells" href="/en/manuals/paybridge/availability">
    Decide where the method is turned on and in which channels.
  </Card>

  <Card title="Supported methods by country" icon="globe" href="/en/manuals/paybridge/supported-methods">
    The methods PayBridge considers in each country.
  </Card>
</CardGroup>
