Core entities

This diagram shows how the main building blocks of Midaz connect to support financial operations at scale. In Figure 1, you can find an overview of the system’s operation.

​

Core components

​

Midaz

At the center of it all. Midaz coordinates everything, from data persistence to business logic, so you can focus on what matters.

​

Data Layer

All data flows into the persistent data layer, ensuring durability, consistency, and performance across the system.

​

Domains and relationships

​

Organizations

Each organization represents a distinct environment using Midaz. It can hold one or many ledgers, depending on how you structure your data.

​

Ledgers

Ledgers are where all financial activity happens. They track balances, store assets, and power transactions. Every ledger belongs to an organization. From here, the system branches into:

• Assets: define what kind of value is tracked.
• Portfolios: group related accounts under a shared purpose.

​

Assets

Assets define the units of value, like BRL, USD, points, or tokens. Every account is tied to a specific asset.

​

Portfolios

Portfolios group accounts by business logic. You can have as many portfolios as needed to organize your financial structure. Each portfolio contains one or more accounts.

​

Accounts & Segments

Accounts are tied to portfolios and represent individual balances. They’re grouped by segments, which help you isolate data by customer, product, region, or any other dimension. Segments make it easier to track and report with precision.

​

Transactions

Transactions move value between accounts. Each transaction is made up of operations (debits and credits), and all operations follow the rules defined in your chart-of-account. This setup keeps your logic consistent, traceable, and aligned with your business model.

​

In short

Midaz gives you a powerful, modular structure:

• Organizations manage ledgers.
• Ledgers hold assets and portfolios.
• Portfolios contain accounts, grouped by segment.
• Transactions move value and follow strict rules.
• All data is synced and stored reliably.