Representa a personas u organizaciones detrás de las cuentas Midaz, almacenando identidad, contacto y atributos de cumplimiento en el CRM.
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, almacenando atributos relacionados con la identidad como nombre, número de documento, datos de contacto y direcciones.Los Holders son gestionados por CRM y no pertenecen al dominio transaccional del ledger. Enriquecen las cuentas del ledger con datos relevantes para el negocio sin interferir con la lógica, consistencia o rendimiento del ledger.Cada Holder es de uno de dos tipos: Persona Natural (Natural Person) o Persona Jurídica (Legal Person).
Para un recorrido paso a paso sobre cómo crear y gestionar holders, consulte Primeros pasos con CRM.
El tipo de holder determina qué campos están disponibles y cómo se trata la entidad en la plataforma. Se define al momento de la creación y no puede cambiarse posteriormente.
Representa a un cliente individual. Soporta atributos personales como nombre, género, fecha de nacimiento, estado civil, nacionalidad e información familiar.Usa este tipo para:
Representa a una empresa u organización. Soporta atributos empresariales como nombre comercial, tipo de actividad, fecha de fundación, tamaño de la empresa y 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. Una vez definido, no puede cambiarse — sería necesario crear un nuevo Holder con el tipo correcto.
Varios campos del Holder están cifrados en reposo usando cifrado AES, incluyendo name, document e información de contacto. Esto garantiza que los datos personales sensibles estén protegidos incluso si el almacenamiento subyacente se ve comprometido.
Nunca almacenes información sensible en el objeto metadata. Los metadatos no están cifrados y se almacenan en texto plano.
Para la lista completa de campos protegidos y estrategias de cifrado, consulta Seguridad de datos del CRM.
Eliminar un Holder — Eliminar lógicamente o remover permanentemente un Holder.
Todas las solicitudes a la API del CRM requieren el header X-Organization-Id. Si Access Manager está habilitado, también se requiere un header Authorization con un token Bearer.
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 escribir código.Aprende más en la guía de Gestión de Holders.
