Skip to main content
Use Midaz Module to manage Holders through the CRM plugin. Holders represent the people or organizations behind your accounts, and in the console you can create, view, edit, and manage their complete information.

​
What are Holders?

A Holder represents individuals (Natural Person) or companies (Legal Person) associated with your Midaz accounts. Each holder stores:
  • Identity information - Name, document number (CPF/CNPJ), and lifecycle status
  • Contact details - Email addresses and phone numbers for communication
  • Address information - Primary and additional addresses with complete location data
  • Person-specific data - Personal details for individuals or business information for companies
  • Custom metadata - Additional fields for integration and business-specific needs
Holders are managed in the CRM module and connect to ledger accounts through Alias Accounts, keeping customer data organized separately from transactional operations. For technical details about the CRM plugin, refer to the CRM Overview page.

​
Accessing the Holders page

To open the Holders page, select the Holders option from the Accounts section of the left-side menu. The Holders page displays a table listing all Holders in your system.

​
Available actions

From the Holders page, you can:

Create a Holder

Add new individuals or companies to your CRM system

Edit a Holder

Update holder information, contact details, and status

Delete a Holder

Remove holders using soft delete (recoverable) or hard delete (permanent)

​
Understanding Holder types

When creating a Holder in ,you’ll need to select the holder type. This determines which fields and information you can manage:

​
Natural Person (Individual)

For individual customers, ther will be fields for:
  • Basic information: Full name, document (CPF), contact details
  • Personal details: Favorite name, social name, gender, birth date
  • Family information: Civil status, mother’s name, father’s name
  • Demographics: Nationality, country of origin
For corporate customers, there will be fields for:
  • Basic information: Company name, document (CNPJ), contact details
  • Business details: Trade name, company activity, founding date
  • Structure: Company size, company type, business status
  • Legal representation: Representative name, document, role, contact

​
Managing Holder status

The console allows you to manage the holder lifecycle through status changes:
  • ACTIVE - Holder is operational and can be associated with active accounts
  • INACTIVE - Holder is temporarily disabled, preserving history while preventing new operations
  • SUSPENDED - Holder access is restricted, useful for compliance or risk management
  • CLOSED - Holder relationship is terminated, typically before deletion
Status changes can be made when editing a holder. The current status is always visible in the holders list.

​
Common use cases

When onboarding individual customers in the console:
  1. Create a Natural Person holder with personal details
  2. Add primary address and contact information
  3. Link to checking/savings accounts via Alias Accounts
  4. Use metadata for customer-specific attributes (loyalty tier, risk profile, etc.)
When managing corporate accounts in the console:
  1. Create a Legal Person holder with company information
  2. Add legal representative details for compliance
  3. Include business addresses and contact points
  4. Link to corporate treasury and operational accounts
  5. Track company size and activity sector for reporting
Use External ID field in the console to maintain synchronization:
  • Map each holder to your existing CRM using External ID
  • Keep document numbers consistent across systems
  • Use metadata for integration-specific fields
  • Update status in console to reflect external system changes

​
Best practices

1

Choose the correct holder type at creation

Select Natural Person for individuals and Legal Person for companies when creating. This cannot be changed later and determines available fields in the console forms.
2

Keep document numbers accurate

Document numbers (CPF, CNPJ) must be unique and properly formatted. The console validates format, but ensure accuracy for regulatory compliance.
3

Maintain updated contact information

Regularly update email addresses and phone numbers in the console to ensure effective customer communication.
4

Use External ID for integration

When creating holders, fill in the External ID field to map to your existing customer database for seamless system integration.
5

Leverage metadata for custom needs

Use the Metadata tab in holder forms to store additional information without modifying the core structure.
6

Manage status transitions properly

Use status updates (Active → Suspended → Inactive → Closed) to reflect customer relationship changes before deletion.