Organisational hierarchy

Think of this as your control panel. Each level exposes specific controls: Organisation (Payment Channels, global settings), OU (regional/brand structure, user scope), Outlet (TIDs, payment acceptance). From here you switch scope, manage entities, and control availability.

flowchart TD
  MO["Merchant Organisation"] --> OU1["OU: Region A"]
  MO --> OU2["OU: Region B"]
  OU1 --> OA["Outlet A"]
  OU1 --> OB["Outlet B"]
  OU2 --> OC["Outlet C"]
  MO --> PC["Payment Channels: MIDs, schemes, currencies"]
  OA --> T1["TID-001"]
  OB --> T2["TID-002"]

Glossary (acronyms & terms)

• OU (Organisational Unit): A branch under the Merchant Organisation (e.g., region, brand, department).
• Outlet: A leaf node that takes payments (e.g., store, website).
• Payment Channel: Credentials & settings used to process transactions (e.g., MID, scheme, currency).
• MID (Merchant ID): The identifier issued by the acquirer for a merchant account.
• MCC (Merchant Category Code): ISO 18245 code describing the business type.
• Channel (eCom / MOTO / POS): The capture method for transactions.
• TID (Terminal ID): Identifier assigned to an Outlet; must be unique to that outlet.

flowchart LR
  PS["Select a node in the profile switcher"] --> SCOPE["Portal scope changes"]
  SCOPE --> LISTS["Lists and reports reflect the selected scope"]
  SCOPE --> SETTINGS["Settings depend on the node and your permissions"]
  SETTINGS --> CHANNELS["Manage payment channels at organisation level"]

Navigate the hierarchy

1. In the top-right profile switcher, click your merchant name.
2. Click "Navigate Organisational Hierarchy."
3. Use the side panel to browse Organisational Units and Outlets.
4. Click Select on the node you want; the portal switches to that scope.

Icons help distinguish OU vs Outlet in the list.

Payment Channels

What they are: The processing “pipes” (one or more per organisation) with attributes like MID, scheme, currency, channel, MCC.

Where to manage:

• View from Organisation or OU scope.
• Enable/Disable only at Organisation scope. Lock icon indicates a higher-level restriction.

View details

1. Go to Settings → Organisational hierarchy.
2. Open the required node (usually Organisation).
3. Click Payment Channels → Edit to view.

Enable/Disable

1. At Organisation level, open Payment Channels → Edit.
2. Toggle Enable/Disable, then Update.
3. Status indicators: green dot = active, red dot = disabled, lock = controlled at higher level.

Add an Organisational Unit or Outlet

1. Settings → Organisational hierarchy.
2. Navigate to the parent node (Organisation or target OU).
3. Click Add organisational unit or outlet.
4. Choose Type (OU or Outlet) and Name.
5. If adding an Outlet, select TIDs to assign.
6. Add to save.

Assign / Unassign TIDs (Outlet)

1. Scope to the Outlet.
2. Click Edit beside TIDs.
3. Select one or more TIDs (or Select all), then Done.

Deactivate / Activate nodes

Deactivate an OU/Outlet to prevent new activity while preserving historical data.

• To deactivate an OU, first deactivate all children (its OUs and Outlets).
• To reactivate an Outlet/OU, all parent OUs above it must be active.

Steps

1. Open the node.
2. Use Deactivate/Activate (based on your permissions).
3. Reactivate in reverse order if previously deactivated.

   flowchart TD
     Q["Deactivate an organisational unit"] --> C{"Any active children?"}
     C -->|Yes| BLOCK["Deactivate child units and outlets first"]
     C -->|No| OK["Deactivate the organisational unit"]
     OK --> REACT["To reactivate, activate parents before this unit"]

Troubleshooting

• Can’t enable a channel? You may be below organisation level or the channel is locked by a higher-level admin.
• Deactivation blocked? Deactivate children first.
• Can’t assign a user to an Outlet? Users attach to Organisation/OU only.
• Payment page not opening? Check if the channel is disabled.

Related

• Users → /docs/users
• Pay page branding → /docs/pay-page-configuration
• Integrations → /docs/integrations · Webhooks → /docs/webhooks