Pular para o conteúdo principal
Um Titular representa a pessoa ou empresa por trás de uma ou mais Contas. Crie o Titular antes de criar Contas Alias que conectam as informações de conta voltadas ao cliente às Contas do Ledger.

Antes de começar


Decida se o Titular é um registro Individual ou Corporate. O tipo selecionado controla quais campos de identidade e registro aparecem no formulário.

Crie o Titular


1
Acesse a página Titulares e clique no botão Novo Titular.
2
Uma janela será aberta para você escolher o tipo de Titular que deseja criar.
  • Se você selecionar Individual (Pessoa Física), será redirecionado para a página Novo Titular, onde poderá informar os dados do indivíduo.
  • Se você selecionar Corporate (Pessoa Jurídica), será redirecionado para a página Novo Titular, onde poderá informar os dados da empresa.
3
Siga as instruções na tela para preencher todas as informações necessárias e clique em Salvar.
4
Se a criação for bem-sucedida, você receberá uma mensagem de confirmação e a lista será atualizada para exibir o novo Titular.

Guia de campos


Individual (Pessoa Física)

Informações Básicas
CampoO que informarExemplo
ID ExternoID opcional do seu CRM, core banking, KYC ou sistema de clientes.customer_123
Tipo de TitularCampo somente leitura que indica o tipo de Titular.Individual
NomeNome completo do Titular.John Doe
DocumentoCPF, identificação nacional ou CNPJ exigido pela sua operação.12345678900
Informações de Contato
CampoO que informarExemplo
E-mail PrincipalE-mail principal usado para contatar o Titular.john.doe@example.com
E-mail SecundárioE-mail alternativo usado para contatar o Titular.john.doe2@example.com
CelularTelefone de contato, incluindo código de país ou DDD quando necessário.+5511999999999
Outro TelefoneTelefone alternativo, incluindo código de país ou DDD quando necessário.+551188888888
Endereços
CampoO que informarExemplo
Endereço Linha 1Nome da rua e número do edifício.Rua Botucatu 10
Endereço Linha 2Detalhes adicionais do endereço, por exemplo, número do apartamento ou sala.Casa B
CEPCódigo postal ou CEP.04023060
CidadeCidade onde o endereço está localizado.São Paulo
EstadoEstado, província ou região.SP
PaísCódigo de país de duas letras (ISO 3166-1 alpha-2).BR
Dados Pessoais
CampoO que informarExemplo
Nome PreferidoApelido ou nome preferido.Johnny
Nome SocialNome social, se diferente do nome legal.Johnny Doe
GêneroIdentidade de gênero da pessoa.Male
Data de NascimentoData de nascimento no formato mm/dd/aaaa.12-01-1990
Estado CivilEstado civil — por exemplo: Solteiro, Casado ou Divorciado.Married
NacionalidadeNacionalidade, por exemplo, brasileira.Brazilian
Nome da MãeNome completo da mãe.Jane Doe
Nome do PaiNome completo do pai.Richard Doe
StatusStatus atual da pessoa no sistema.Active
Metadados
CampoO que informarExemplo
ChaveNome opcional do campo de classificação ou integração.kycStatus
ValorValor da chave de metadado.approved

Empresa (Pessoa Jurídica)

Informações Básicas
CampoO que informarExemplo
ID ExternoID opcional do seu CRM, core banking, KYC ou sistema de clientes.company_123
TipoCampo somente leitura que indica o tipo de Titular.Legal Person
NomeNome da empresa no sistema.ACME
DocumentoCPF, identificação nacional ou CNPJ exigido pela sua operação.59014899000183
Informações de Contato
CampoO que informarExemplo
E-mail PrincipalE-mail principal usado para contatar a empresa.acme@example.com
E-mail SecundárioE-mail alternativo usado para contatar o Titular.acme2@example.com
CelularTelefone de contato, incluindo código de país ou DDD quando necessário.+5511999999999
Outro TelefoneTelefone alternativo, incluindo código de país ou DDD quando necessário.+551188888888
Endereços
CampoO que informarExemplo
Endereço Linha 1Nome da rua e número do edifício.Rua Silva 100
Endereço Linha 2Detalhes adicionais do endereço, por exemplo, número do apartamento ou sala.Cj 12
CEPCódigo postal ou CEP.04013060
CidadeCidade onde o endereço está localizado.São Paulo
EstadoEstado, província ou região.SP
PaísCódigo de país de duas letras (ISO 3166-1 alpha-2).BR
Dados Empresariais
CampoO que informarExemplo
Nome FantasiaNome comercial registrado da empresa, se aplicável.ACME BR
AtividadeTipo de negócio ou atividade que a empresa exerce.Electronic devices development
Tipo JurídicoEstrutura jurídica da empresa.Limited Liability
Data de FundaçãoData em que a empresa foi constituída.01-01-2010
Porte da EmpresaClassificação de porte da empresa.Medium
StatusStatus atual da pessoa no sistema.Active
Nome do RepresentanteNome do representante legal.Jane Doe
Documento do RepresentanteNúmero do documento do representante legal.43522116992
E-mail do RepresentanteEndereço de e-mail do representante legal.janedoe@corporate.com
CargoCargo do representante legal dentro da empresa.CFO
Metadados
CampoO que informarExemplo
ChaveNome opcional do campo de classificação ou integração.kycStatus
ValorValor 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 em Criando uma Conta Alias.

Equivalente na API