A Holder is the core entity in CRM, representing the individual or organization associated with a ledger account in Midaz. It stores identity-related attributes, contact details, and person-specific characteristics.
A Holder is the core entity in CRM. It represents a real-world individual or organization behind a Midaz ledger account, storing identity-related attributes such as name, document number, contact details, and addresses.Holders are managed by CRM and don’t belong to the ledger’s transactional domain. They enrich ledger accounts with business-relevant data without interfering with the ledger’s logic, consistency, or performance.Each Holder is one of two types: Natural Person (individual) or Legal Person (company/organization).
The holder type determines which fields are available and how the entity is treated across the platform. It is set at creation and cannot be changed later.
Represents an individual customer. It supports personal attributes such as name, gender, birth date, civil status, nationality, and family information.Use this type for:
Represents a company or organization. It supports business attributes such as trade name, activity type, founding date, company size, and legal representative details.Use this type for:
Corporate treasury accounts
Business partners and suppliers
Institutional clients
Choose the holder type carefully at creation. Once set, it cannot be changed — you would need to create a new Holder with the correct type.
Several Holder fields are encrypted at rest using AES encryption, including name, document, and contact information. This ensures that sensitive personal data is protected even if the underlying storage is compromised.
Never store sensitive information in the metadata object. Metadata is not encrypted and is stored in plain text.
For the full list of protected fields and encryption strategies, see CRM data security.
You can manage Holders through the Holders page in the Midaz Module of Lerian Console. The console provides a visual interface for creating, viewing, editing, and deleting Holders without writing code.Learn more in the Managing Holders guide.
