Criando um Titular

Um Titular representa a pessoa ou empresa por trás de uma ou mais Contas. Crie o Titular antes de criar Contas Alias. Uma Conta Alias conecta informações de conta voltadas ao cliente a uma Conta do ledger.

Antes de começar

Decida se o Titular é um registro Pessoa Física ou Pessoa Jurídica. O tipo escolhido controla quais campos de identidade e registro o formulário mostra.

Criar o Titular

Acesse a página Titulares. Clique no botão Novo Titular.

Uma janela abre. Escolha o tipo de Titular que você quer criar.

Se você selecionar Pessoa Física (Natural Person), a página Novo Titular abre para você informar os dados da pessoa física.
Se você selecionar Pessoa Jurídica (Legal Person), a página Novo Titular abre para você informar os dados da empresa.

Siga as instruções na tela para informar os dados obrigatórios. Clique em Criar Titular.

Quando a criação for bem-sucedida, você vê uma mensagem de confirmação. A lista atualiza e mostra o novo Titular.

Guia de campos

Pessoa Física

Informações Básicas

Campo	O que informar	Exemplo
External ID	ID opcional do seu CRM, core banking, KYC ou sistema de clientes.	`customer_123`
Tipo de titular	Campo somente leitura que indica o tipo de Titular.	`Natural Person`
Nome	O nome completo do Titular.	`John Doe`
Documento	Número de identificação fiscal, documento de identidade nacional ou número de registro de empresa esperado pela sua operação.	`12345678900`

Informações de Contato

Campo	O que informar	Exemplo
E-mail Principal	O e-mail principal usado para contatar o Titular.	`john.doe@example.com`
E-mail Secundário	Um e-mail alternativo usado para contatar o Titular.	`john.doe2@example.com`
Telefone Celular	Número de telefone de contato, incluindo código de país ou DDD quando necessário.	`+5511999999999`
Outro Telefone	Um número de telefone alternativo, incluindo código de país ou DDD quando necessário.	`+551188888888`

Endereços

Campo	O que informar	Exemplo
Endereço Linha 1	Nome da rua e número do prédio.	`Rua Botucatu 10`
Endereço Linha 2	Detalhes extras do endereço, por exemplo, número de apartamento ou sala.	`Casa B`
CEP	Código postal ou CEP.	`04023060`
Cidade	Cidade onde o endereço está localizado.	`São Paulo`
Estado	Estado, província ou região.	`SP`
País	Código de país de duas letras (ISO 3166-1 alpha-2).	`BR`

Detalhes Pessoais

Campo	O que informar	Exemplo
Nome Preferido	Apelido ou nome preferido.	`Johnny`
Nome Social	Nome social, se diferente do nome legal.	`Johnny Doe`
Gênero	Identidade de gênero da pessoa.	`Male`
Data de Nascimento	Data de nascimento no formato YYYY-MM-DD.	`1990-01-01`
Estado Civil	Estado civil — por exemplo: Solteiro(a), Casado(a) ou Divorciado(a).	`Married`
Nacionalidade	Nacionalidade, por exemplo, brasileira.	`Brazilian`
Nome da Mãe	Nome completo da mãe.	`Jane Doe`
Nome do Pai	Nome completo do pai.	`Richard Doe`
Status	Status atual da pessoa física no sistema.	`Active`

Metadados

Campo	O que informar	Exemplo
Chave	Nome de campo de classificação ou integração, opcional.	`kycStatus`
Valor	Valor da chave de metadados.	`approved`

Pessoa Jurídica

Informações Básicas

Campo	O que informar	Exemplo
External ID	ID opcional do seu CRM, core banking, KYC ou sistema de clientes.	`company_123`
Tipo	Campo somente leitura que indica o tipo de Titular.	`Legal Person`
Nome	O nome da empresa no sistema.	`ACME`
Documento	Número de identificação fiscal, documento de identidade nacional ou número de registro de empresa esperado pela sua operação.	`59014899000183`

Informações de Contato

Campo	O que informar	Exemplo
E-mail Principal	O e-mail principal usado para contatar a empresa.	`acme@example.com`
E-mail Secundário	Um e-mail alternativo usado para contatar o Titular.	`acme2@example.com`
Telefone Celular	Número de telefone de contato, incluindo código de país ou DDD quando necessário.	`+5511999999999`
Outro Telefone	Um número de telefone alternativo, incluindo código de país ou DDD quando necessário.	`+551188888888`

Endereços

Campo	O que informar	Exemplo
Endereço Linha 1	Nome da rua e número do prédio.	`Rua Silva 100`
Endereço Linha 2	Detalhes extras do endereço, por exemplo, número de apartamento ou sala.	`Cj 12`
CEP	Código postal ou CEP.	`04013060`
Cidade	Cidade onde o endereço está localizado.	`São Paulo`
Estado	Estado, província ou região.	`SP`
País	Código de país de duas letras (ISO 3166-1 alpha-2).	`BR`

Detalhes da Empresa

Campo	O que informar	Exemplo
Nome Fantasia	O nome comercial registrado da empresa, se aplicável.	`ACME BR`
Atividade	O tipo de negócio ou atividade que a empresa exerce.	`Electronic devices development`
Tipo Jurídico	A estrutura jurídica da empresa.	`Limited Liability`
Data de Fundação	A data em que a empresa foi criada, no formato YYYY-MM-DD.	`2025-01-01`
Porte da Empresa	A classificação de porte da empresa.	`Medium`
Status	Status atual da empresa no sistema.	`Active`
Nome do Representante	O nome do representante legal.	`Jane Doe`
Documento do Representante	O número do documento do representante legal.	`43522116992`
E-mail do Representante	O endereço de e-mail do representante legal.	`janedoe@corporate.com`
Papel	O papel do representante legal dentro da empresa.	`CFO`

Metadados

Campo	O que informar	Exemplo
Chave	Nome de campo de classificação ou integração, opcional.	`kycStatus`
Valor	Valor da chave de metadados.	`approved`

Próximos passos

Depois de criar o Titular, crie uma Conta Alias para conectar o Titular a uma Conta do ledger Midaz. Veja Criando uma Conta Alias.

Equivalente de API

Endpoint para criar Titular

Midaz Core

CRM

Fees

Criando um Titular

Antes de começar

Criar o Titular

Guia de campos

Pessoa Física

Pessoa Jurídica

Próximos passos

Equivalente de API

​Antes de começar

​Criar o Titular

​Guia de campos

​Pessoa Física

​Pessoa Jurídica

​Próximos passos

Equivalente de API

Antes de começar

Criar o Titular

Guia de campos

Pessoa Física

Pessoa Jurídica

Próximos passos