post https://sandbox.auth.flowfinance.com.br/persons
Esse endpoint deve ser utilizado para cadastrar uma Pessoa do tipo física, usando um nº de CPF como identificador.
Parâmetros do Body
name
(string, obrigatório): O nome completo da pessoa.
personType
(string, obrigatório): O tipo da pessoa, informar o valor como "NATURAL" para o cadastro de uma pessoa física. Possíveis valores: NATURAL, LEGAL.
taxpayerId
(string, obrigatório): O número do documento CPF para identificação da Pessoa.
documents
(object, obrigatório): Objeto contendo as 'keys' das URLs 'pre-signed' dos documentos de identificação (documentIdentification) e comprovante de endereço (proofOfAddress).
idDocument
(object, obrigatório): Objeto para detalhar o documento de identificação que esta sendo enviado.issueDate
(string, obrigatório): Data de emissão do documento.
issuer
(string, obrigatório): Orgão responsável pela emissão do documento.
number
(string, obrigatório): Número do documento.
type
(string, obrigatório): Tipo do documento. Valores aceitos: CNH, PASSPORT, RG, RNE.
birthDate
(string, obrigatório): Data de nascimento da Pessoa a ser cadastrada no formato "AAAA-MM-DD".
motherName
(string, obrigatóri): Nome da mãe.
pep
(boolean, obrigatório): Campo para indica se a pessoa é politicamente exposta.
emailAddress
(string, obrigatório): Endereço de e-mail para contato com a pessoa cadastrada.
phone
(object, obrigatório): Objeto contendo os dados do telefone de contato.countryCode
(string): Código do país.
areaCode
(string): Código de área.
number
(string): Número do telefone.
address
(object, obrigatório): Objeto contendo detalhes do endereço de cadastro.streetNumber
(string): Número do endereço informado.
streetName
(string): Nome da rua.
postalCode
(string): Código de CEP para o endereço.
district
(string): Campo para informar o bairro.
city
(string): Nome da cidade.
stateCode
(string): Código da UF para o estado do endereço.
countryCode
(string): Código do país.
extraInfo
(string): Complemento do endereço.
fundManagerId
(string/uuid v4): ID do gestor do Fundo, se aplicável.
fundSecuritizerId
(string/uuid v4): ID da securitizadora do Fundo, se aplicável.
fundAdministratorId
(string/uuid v4): ID do Admnistrador do Fundo, se aplicável.
Resposta
A resposta da requisição será um JSON representando o retorno obtido para os campos enviados.
Em caso de sucesso será retornado um status_code "200-OK". Em caso de falha será retornado um código 40x com a mensagem indicativa do erro.
id
(string/uuid v4): ID gerado para o cadastro realizado da Pessoa física.
Exemplo de JSON:
{
"id": ""
}