Guides

Ledgers

Suggest Edits

A Ledger acts as the Organization’s financial backbone, maintaining a precise record of all Transactions and Operations. Every financial event—deposits, withdrawals, transfers, fees—is tracked within a Ledger, ensuring complete traceability and control.

Organizations can use multiple Ledgers to segregate financial operations. For example, a bank may maintain separate Ledgers for different business lines, geographies, or regulatory requirements. Alternatively, a single Ledger can handle all operations for a streamlined approach.


Ledger Structure

  • Ledger > Organization: Each Organization can own multiple Ledgers, but each Ledger belongs to only one Organization. This ensures financial separation and accountability.
    • Multiple Ledgers should only be used when data or operational segregation is required—for example, for internal treasury operations versus customer accounts.

🚧

Important Note

Transactions cannot occur directly between Ledgers without orchestration. If you need to manage cross-ledger transactions, you must implement appropriate workflows to ensure consistency.


Key Characteristics

  • Ledgers ensure financial integrity and operational transparency.
  • All Accounts and Transactions exist within a Ledger, forming a complete financial system.
  • Each Ledger maintains a balanced set of Accounts.
  • Multiple Ledgers can be used for segmentation, but cross-ledger transactions require explicit handling.

Multiple Ledgers for Seamless Organization

Midaz provides the capability to create multiple Ledgers for each organization, offering enhanced flexibility and control. This feature is particularly beneficial for companies with diverse operational needs, such as separating financial records by country, department, or specific business function.

Example Use Case

Consider a global enterprise with business in multiple regions:

  • Ledger 1: US Business
  • Ledger 2: EU Business
  • Ledger 3: APAC Business

By using separate Ledgers, the company can maintain region-specific transaction records, tax considerations, and currency settings while retaining a unified oversight of all operations.


Customizing Ledgers for Specific Needs

One of the standout features of Ledgers in Midaz is the ability to tailor configurations based on individual requirements. For example, the same asset can be configured differently in separate Ledgers:

Example
To represent Bitcoin (BTC) with unique settings across Ledgers:

  • Ledger 1: BTC with 10 decimal places
  • Ledger 2: BTC with 20 decimal places

In this case, you simply create the BTC asset independently in each Ledger, applying the necessary configuration.

This approach enables granular control over asset management, aligning with specific operational or regulatory needs.


Benefits of Using Ledgers in Midaz

  • Enhanced Organization: Maintain clear and distinct financial records tailored to various aspects of your business.
  • Custom Configurations: Adjust asset settings, currencies, or other parameters per Ledger to meet localized or departmental needs.
  • Scalability: Easily add or modify Ledgers as your organization grows or diversifies.
  • Transparency: Gain comprehensive insights across all financial activities, with each Ledger contributing to a cohesive operational picture.

Managing Ledgers

To manage your Ledgers you can use the Ledgers API or the Ledgers page on Midaz Console.

View Ledgers Details

  • Via API:
    • To view the details of all Ledgers, use the List Ledgers endpoint.
    • To view the details of a specific Ledger, use the Retrieve a Ledger endpoint.
  • Via Console: Access the Ledgers page to view the detais of a Ledger. For more information, refer to the Managing Ledgers page.

Create a Ledger


Edit a Ledger


Delete a Ledger

Updated about 2 months ago