Skip to main content
Un Holder es la entidad principal en CRM. Representa a un individuo u organización del mundo real detrás de una cuenta del ledger en Midaz. Un Holder almacena atributos de identidad como el nombre, el número de documento, los datos de contacto y las direcciones. CRM gestiona los Holders. Los Holders no pertenecen al dominio transaccional del ledger. Enriquecen las cuentas del ledger con datos de negocio. No afectan la lógica, la consistencia ni el rendimiento del ledger. Cada Holder es de uno de dos tipos: Persona Natural (Natural Person) o Persona Jurídica (Legal Person).
Para crear y gestionar holders paso a paso, consulta Primeros pasos con CRM.

​
Tipos de Holder

El tipo de holder controla qué campos están disponibles. También define cómo la plataforma trata la entidad. Eliges el tipo al momento de la creación. No puedes cambiarlo después.

​
Persona Natural (Natural Person)

El tipo Persona Natural representa a un cliente individual. Soporta atributos personales como el nombre, el género, la fecha de nacimiento, el estado civil, la nacionalidad y la información familiar. Usa este tipo para:
  • Titulares de cuentas bancarias individuales
  • Propietarios de billeteras personales
  • Trabajadores independientes o autónomos
El tipo Persona Jurídica representa a una empresa u organización. Soporta atributos empresariales como el nombre comercial, el tipo de actividad, la fecha de fundación, el tamaño de la empresa y los detalles del representante legal. Usa este tipo para:
  • Cuentas de tesorería corporativa
  • Socios comerciales y proveedores
  • Clientes institucionales
Elige el tipo de holder con cuidado al momento de la creación. No puedes cambiarlo después. Para usar un tipo diferente, crea un nuevo Holder.

​
Campos del Holder

​
Campos principales

​
Campos de dirección

El objeto addresses soporta hasta tres direcciones: primary, additional1 y additional2. Cada dirección contiene:

​
Campos de contacto

​
Campos de Persona Natural

Disponibles solo cuando type es NATURAL_PERSON.

​
Campos de Persona Jurídica

Disponibles solo cuando type es LEGAL_PERSON.

​
Representante

El objeto representative dentro de legalPerson almacena los detalles del representante legal de la empresa:

​
Seguridad de los datos

Midaz cifra varios campos del Holder en reposo, incluidos name, document y los campos de contacto. Esto protege los datos incluso si alguien accede al almacenamiento.
Nunca almacenes información sensible en el objeto metadata. Midaz no cifra los metadatos y los almacena en texto plano.
Para la lista completa de campos protegidos y estrategias de cifrado, consulta Seguridad de datos del CRM.

​
Gestionando Holders

​
Vía API

Usa la API del CRM para gestionar Holders programáticamente:
Cada solicitud a la API del CRM incluye el ID de la organización en la ruta de la URL, por ejemplo /organizations/{organization_id}/holders. Si habilitas Access Manager, agrega un header Authorization con un token Bearer.

​
Vía Lerian Console

Puedes gestionar Holders a través de la página Holders en el Módulo Midaz de Lerian Console. La consola ofrece una interfaz visual para crear, ver, editar y eliminar Holders sin código. Aprende más en la guía de Gestión de Holders.

​
Próximos pasos

Alias Accounts

Aprende cómo las Alias Accounts vinculan Holders a cuentas del Ledger en Midaz.

Usando CRM

Sigue la guía paso a paso para registrar Holders y crear Alias Accounts.