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 as informações de conta voltadas ao cliente a uma Conta do Ledger.

Antes de começar

Decida se o Titular é um registro Individual ou Corporate. O tipo que você escolhe controla quais campos de identidade e registro o formulário exibe.

Crie o Titular

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

Uma janela abre. Escolha o tipo de Titular que deseja criar.

Se você selecionar Individual (Pessoa Física), a página Novo Titular abre para você informar os dados do indivíduo.
Se você selecionar Corporate (Pessoa Jurídica), a página Novo Titular abre para você informar os dados da empresa.

Siga as instruções na tela para preencher as informações necessárias. Clique em Criar Titular.

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

Guia de campos

Individual (Pessoa Física)

Informações Básicas

Campo	O que informar	Exemplo
ID Externo	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	Nome completo do Titular.	`John Doe`
Documento	CPF, identificação nacional ou CNPJ exigido pela sua operação.	`12345678900`

Informações de Contato

Campo	O que informar	Exemplo
E-mail Principal	E-mail principal usado para contatar o Titular.	`john.doe@example.com`
E-mail Secundário	E-mail alternativo usado para contatar o Titular.	`john.doe2@example.com`
Celular	Telefone de contato, incluindo código de país ou DDD quando necessário.	`+5511999999999`
Outro Telefone	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 edifício.	`Rua Botucatu 10`
Endereço Linha 2	Detalhes adicionais do endereço, por exemplo, número do 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`

Dados 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, Casado ou Divorciado.	`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 no sistema.	`Active`

Metadados

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

Empresa (Pessoa Jurídica)

Informações Básicas

Campo	O que informar	Exemplo
ID Externo	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	Nome da empresa no sistema.	`ACME`
Documento	CPF, identificação nacional ou CNPJ exigido pela sua operação.	`59014899000183`

Informações de Contato

Campo	O que informar	Exemplo
E-mail Principal	E-mail principal usado para contatar a empresa.	`acme@example.com`
E-mail Secundário	E-mail alternativo usado para contatar o Titular.	`acme2@example.com`
Celular	Telefone de contato, incluindo código de país ou DDD quando necessário.	`+5511999999999`
Outro Telefone	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 edifício.	`Rua Silva 100`
Endereço Linha 2	Detalhes adicionais do endereço, por exemplo, número do 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`

Dados Empresariais

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

Metadados

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

Próximos passos

Após criar o Titular, crie uma Conta Alias para conectar o Titular a uma Conta do Ledger do Midaz. Consulte Criando uma Conta Alias.

Equivalente na API

Endpoint Criar Titular

Midaz Core

CRM

Fees

Criando um Titular

Antes de começar

Crie o Titular

Guia de campos

Individual (Pessoa Física)

Empresa (Pessoa Jurídica)

Próximos passos

Equivalente na API

​Antes de começar

​Crie o Titular

​Guia de campos

​Individual (Pessoa Física)

​Empresa (Pessoa Jurídica)

​Próximos passos

Equivalente na API

Antes de começar

Crie o Titular

Guia de campos

Individual (Pessoa Física)

Empresa (Pessoa Jurídica)

Próximos passos