Crear un Titular

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 la cuenta de cara al cliente con una Cuenta del ledger.

Antes de empezar

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

Crea el Titular

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

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 de la persona.
Si seleccionas Corporate (Persona jurídica), se abre la página New Holder para que ingreses la información de la empresa.

Sigue las instrucciones en pantalla para ingresar la información requerida. Haz clic en Create Holder.

Cuando la creación se completa con éxito, 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 externo opcional de tu CRM, core bancario, KYC o sistema de clientes.	`customer_123`
Holder type	Un campo de solo lectura que indica el tipo de Titular.	`Natural Person`
Name	El nombre completo del Titular.	`John Doe`
Document	Identificación tributaria, documento nacional de identidad o número de registro de empresa que exige tu operación.	`12345678900`

Contact Information

Campo	Qué ingresar	Ejemplo
Primary Email	El correo electrónico principal usado para contactar al Titular.	`john.doe@example.com`
Secondary Email	Un correo electrónico alternativo usado para contactar al Titular.	`john.doe2@example.com`
Mobile Phone	Número de teléfono de contacto, incluido el código de país o de área cuando se requiera.	`+5511999999999`
Other Phone	Un número de teléfono alternativo, incluido el código de país o de área cuando se requiera.	`+551188888888`

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 encuentra 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 es diferente 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: Single, Married o Divorced.	`Married`
Nationality	Nacionalidad, por ejemplo, Brazilian.	`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 de campo opcional 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 externo opcional de tu CRM, core bancario, KYC o sistema de clientes.	`company_123`
Type	Un campo de solo lectura que indica el tipo de Titular.	`Legal Person`
Name	El nombre de la empresa en el sistema.	`ACME`
Document	Identificación tributaria, documento nacional de identidad o número de registro de empresa que exige tu operación.	`59014899000183`

Contact Information

Campo	Qué ingresar	Ejemplo
Primary Email	El correo electrónico principal usado para contactar a la empresa.	`acme@example.com`
Secondary Email	Un correo electrónico alternativo usado para contactar al Titular.	`acme2@example.com`
Mobile Phone	Número de teléfono de contacto, incluido el código de país o de área cuando se requiera.	`+5511999999999`
Other Phone	Un número de teléfono alternativo, incluido el código de país o de área cuando se requiera.	`+551188888888`

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 encuentra 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	El nombre comercial registrado de la empresa, si corresponde.	`ACME BR`
Activity	El tipo de negocio o actividad al que se dedica la empresa.	`Electronic devices development`
Legal Type	La estructura legal de la empresa.	`Limited Liability`
Founding Date	La fecha en que se constituyó la empresa, en formato YYYY-MM-DD.	`2025-01-01`
Company Size	La clasificación por tamaño de la empresa.	`Medium`
Status	Estado actual de la empresa en el sistema.	`Active`
Representative Name	El nombre del representante legal.	`Jane Doe`
Representative Document	El número de documento del representante legal.	`43522116992`
Representative Email	La dirección de correo electrónico del representante legal.	`janedoe@corporate.com`
Role	El cargo del representante legal dentro de la empresa.	`CFO`

Metadata

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

Qué hacer a continuación

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

Equivalente en la API

Endpoint para crear un Titular

Midaz Core

CRM

Fees

Crear un Titular

Antes de empezar

Crea el Titular

Guía de campos

Individual

Corporate

Qué hacer a continuación

Equivalente en la API

​Antes de empezar

​Crea el Titular

​Guía de campos

​Individual

​Corporate

​Qué hacer a continuación

Equivalente en la API

Antes de empezar

Crea el Titular

Guía de campos

Individual

Corporate

Qué hacer a continuación