Crear un Titular

Registra un nuevo Titular en el Midaz Module para representar a la persona o entidad propietaria de una o más Cuentas y centralizar su información clave.

Un Titular representa a la persona o empresa detrás de una o más Cuentas. Crea el Titular antes de crear Cuentas Alias. Una Cuenta Alias conecta la información de cuenta orientada al cliente con una Cuenta del ledger.

​

Antes de comenzar

---

Decide si el Titular es un registro Individual o Corporate. El tipo que eliges controla qué campos de identidad y registro muestra el formulario.

​

Crear el Titular

---

1. Ve a la página Holders. Haz clic en el botón New Holder.

2. Se abre una ventana. Elige el tipo de Titular que deseas crear.

   • Si seleccionas Individual (Persona Natural), se abre la página New Holder para que ingreses la información del individuo.
   • Si seleccionas Corporate (Persona Jurídica), se abre la página New Holder para que ingreses la información de la empresa.
3. Sigue las instrucciones en pantalla para ingresar la información requerida. Haz clic en Create Holder.

4. Cuando la creación es exitosa, ves un mensaje de confirmación. La lista se actualiza y muestra el nuevo Titular.

​

Guía de campos

---

​

Individual

Basic Information

Campo	Qué ingresar	Ejemplo
External ID	ID opcional de tu CRM, core banking, KYC o sistema de clientes.	customer_123
Holder type	Campo de solo lectura que indica el tipo de Titular.	Natural Person
Name	Nombre completo del Titular.	John Doe
Document	Identificación fiscal, identificación nacional o número de registro de la empresa según lo requiera tu operación.	12345678900

Contact Information

Campo	Qué ingresar	Ejemplo
Primary Email	Correo principal usado para contactar al Titular.	[e-mail]
Secondary Email	Correo alternativo usado para contactar al Titular.	[e-mail]
Mobile Phone	Número de teléfono de contacto, incluido el código de país o área cuando sea necesario.	[phone]
Other Phone	Número de teléfono alternativo, incluido el código de país o área cuando sea necesario.	[phone]

Addresses

Campo	Qué ingresar	Ejemplo
Address Line 1	Nombre de la calle y número del edificio.	Rua Botucatu 10
Address Line 2	Detalles adicionales de la dirección, por ejemplo, número de apartamento o suite.	Casa B
Zip Code	Código postal.	04023060
City	Ciudad donde se ubica la dirección.	São Paulo
State	Estado, provincia o región.	SP
Country	Código de país de dos letras (ISO 3166-1 alpha-2).	BR

Personal Details

Campo	Qué ingresar	Ejemplo
Favorite Name	Apodo o nombre preferido.	Johnny
Social Name	Nombre social, si difiere del nombre legal.	Johnny Doe
Gender	Identidad de género de la persona.	Male
Birth Date	Fecha de nacimiento en formato YYYY-MM-DD.	1990-01-01
Civil Status	Estado civil — por ejemplo: Soltero, Casado o Divorciado.	Married
Nationality	Nacionalidad, por ejemplo, brasileña.	Brazilian
Mother’s Name	Nombre completo de la madre.	Jane Doe
Father’s Name	Nombre completo del padre.	Richard Doe
Status	Estado actual de la persona en el sistema.	Active

Metadata

Campo	Qué ingresar	Ejemplo
Key	Nombre opcional de campo para clasificación o integración.	kycStatus
Value	Valor para la clave de metadatos.	approved

​

Corporate

Basic Information

Campo	Qué ingresar	Ejemplo
External ID	ID opcional de tu CRM, core banking, KYC o sistema de clientes.	company_123
Type	Campo de solo lectura que indica el tipo de Titular.	Legal Person
Name	Nombre de la empresa en el sistema.	ACME
Document	Identificación fiscal, identificación nacional o número de registro de la empresa según lo requiera tu operación.	59014899000183

Contact Information

Campo	Qué ingresar	Ejemplo
Primary Email	Correo principal usado para contactar a la empresa.	[e-mail]
Secondary Email	Correo alternativo usado para contactar al Titular.	[e-mail]
Mobile Phone	Número de teléfono de contacto, incluido el código de país o área cuando sea necesario.	[phone]
Other Phone	Número de teléfono alternativo, incluido el código de país o área cuando sea necesario.	[phone]

Addresses

Campo	Qué ingresar	Ejemplo
Address Line 1	Nombre de la calle y número del edificio.	Rua Silva 100
Address Line 2	Detalles adicionales de la dirección, por ejemplo, número de apartamento o suite.	Cj 12
Zip Code	Código postal.	04013060
City	Ciudad donde se ubica la dirección.	São Paulo
State	Estado, provincia o región.	SP
Country	Código de país de dos letras (ISO 3166-1 alpha-2).	BR

Company Details

Campo	Qué ingresar	Ejemplo
Trade Name	Nombre comercial registrado de la empresa, si aplica.	ACME BR
Activity	Tipo de negocio o actividad que realiza la empresa.	Electronic devices development
Legal Type	Estructura legal de la empresa.	Limited Liability
Founding Date	Fecha en que se constituyó la empresa, en formato YYYY-MM-DD.	2025-01-01
Company Size	Clasificación de tamaño de la empresa.	Medium
Status	Estado actual de la empresa en el sistema.	Active
Representative Name	Nombre del representante legal.	Jane Doe
Representative Document	Número de documento del representante legal.	43522116992
Representative Email	Correo electrónico del representante legal.	[e-mail]
Role	Rol del representante legal dentro de la empresa.	CFO

Metadata

Campo	Qué ingresar	Ejemplo
Key	Nombre opcional de campo para clasificación o integración.	kycStatus
Value	Valor para la clave de metadatos.	approved

​

Próximos pasos

---

Después de crear el Titular, crea una Cuenta Alias para conectar al Titular con una Cuenta del ledger de Midaz. Consulta Crear una Cuenta Alias.

Equivalente en la API

Endpoint Create Holder