Skip to main content
The Settings tab in the Ledger sidebar allows you to enable validation rules that control how accounts and transactions behave within a specific Ledger. These settings let you enforce account type classification and transaction routing rules directly from the Console, without requiring changes to environment configuration files.
The Settings tab is only available when editing an existing Ledger. It does not appear during Ledger creation.

​
Accessing Ledger Settings

1

Open the Ledgers page

In the Midaz Module, click Ledgers in the Foundation section of the left sidebar.
2

Open the Ledger details

Locate the Ledger you want to configure. Click the three dots () in the Actions column and select Details.
3

Navigate to the Settings tab

In the sidebar that opens, click the Settings tab. You will see the available validation toggles for this Ledger.

​
Available settings

​
Validate Account Type

When this toggle is enabled, only Account Types that have been previously registered for this Ledger will be accepted when creating a new Account. This enforces consistent account classification across your financial structure. Enabling this setting also activates the Account Types menu in the left sidebar, allowing you to manage the registered types for this Ledger.
Once Validate Account Type is enabled, the Account Type field becomes mandatory when creating any new Account under this Ledger. Accounts without a valid type will be rejected.

Managing Account Types

Learn how to create and manage Account Types for your Ledger.

​
Validate Routes

When this toggle is enabled, all transactions must follow pre-configured routing rules that define which source and destination accounts are allowed for each operation type. Transactions that do not match an existing route will be rejected during processing. Enabling this setting also activates the Transaction Routes and Operation Routes menus in the left sidebar.
Before enabling Validate Routes, make sure you have configured at least one Transaction Route and the relevant Operation Routes for your Ledger. Enabling this setting without routes in place will cause all transactions to fail validation.

Managing Transaction Routes

Configure the allowed transaction routes for this Ledger.

Managing Operation Routes

Define allowed source and destination accounts per operation type.

​
API reference

You can also retrieve and update Ledger Settings programmatically via the Midaz API:

Retrieve Ledger Settings

Fetch the current settings for a specific Ledger.

Update Ledger Settings

Enable or disable validation settings for a Ledger via API.