Terminals
Use this page to register and manage POS terminals per restaurant — name, device id, Linkly setup, master device flag, and active status. Plan terminal limits apply to active devices.
Open the screen: Sidebar → Settings → Terminals
Terminals list
What it does
Split list + detail view with filters, plan limit banner, and pagination.
Step-by-step
- Open Terminals.
- Pick Restaurant (first outlet auto-selects).
- Optionally Search — placeholder Search by terminal name... (debounced ~300ms).
- Status filter — default Active; also All or Inactive.
- Read LimitBanner (e.g. active terminals vs plan max) when shown.
- Tap a terminal in the left list to see details on the right.
- Tap refresh to reload table and active count.
List item shows
- Terminal name, Master Device badge when set
- Restaurant name, Linkly configured / Linkly not configured
- Green/red dot for Active / Inactive
Detail panel
Device id, Linkly token status, dates, Edit and Delete actions (when permitted).
Plan limits
Add Terminal is gated when active terminals reach your plan max_terminal limit. Plan-limit errors suggest opening the Subscription page.
Add terminal
What it does
Dialog Add Terminal — creates a device for the filtered restaurant.
Step-by-step
- Tap Add Terminal (disabled at plan limit).
- Restaurant — read-only, matches filter.
- Terminal Name * — required.
- Is Master Device — Yes / No switch.
- Tap Create (Creating... while working).
- Success: API message or Terminal created successfully.
Device id and Linkly token are assigned through the POS pairing flow after creation.
Edit terminal
What it does
Dialog Edit Terminal for an existing row.
Fields
| Field | Editable? |
|---|---|
| Restaurant | Read-only |
| Terminal Name | Yes |
| Device ID | Read-only (greyed) |
| Linkly Token | Read-only (greyed) |
| Status | Active / Inactive switch |
| Is Master Device | Yes / No switch |
Tap Update (Updating... while saving).
Delete terminal
What it does
Confirmation dialog — This action cannot be undone. This will permanently delete the terminal {name}.
Tap Delete to confirm. Success: Terminal deleted successfully.
Permissions
| What you need | Why |
|---|---|
| TERMINALS — READ | View list and details |
| TERMINALS — CREATE | Add Terminal |
| TERMINALS — UPDATE | Edit |
| TERMINALS — DELETE | Delete |