Fluxo de Cadastro e KYC

O processo de cadastro de uma conta deve seguir todas as etapas corretamente para garantir a conformidade com o KYC (Know Your Customer). Após a criação da conta, o sistema de KYC valida as informações fornecidas e retorna o status da conta via webhook, conforme o resultado. Abaixo, detalhamos as etapas do fluxo e os possíveis status pelos quais a conta do cliente pode passar, incluindo as notificações via webhook.

Status da Conta

Status	Descrição
`REGISTER`	A conta foi registrada e está aguardando a validação pelo KYC.
`VALIDATING`	A conta está sendo validada pelo KYC para garantir que todas as informações estão corretas e em conformidade.
`VALIDATED`	A conta foi validada e está pronta para continuar o processo de criação.
`PROCESSING`	A conta está sendo configurada no sistema.
`APPROVED`	A conta foi aprovada e está totalmente funcional.
`REJECTED`	A abertura foi rejeitada por inconsistências nos dados. O cliente pode corrigir as informações e reenviar.
`DENIED`	O KYC não autorizou a abertura da conta. Este é um status final, sem possibilidade de reenvio. A conta fica bloqueada por um determinado tempo e qualquer tentativa de abertura de conta será automaticamente negada pelo KYC.
`DISABLED`	A conta foi desativada, mas pode ser reativada, se necessário.
`BLOCKED`	A conta foi bloqueada e o acesso está impedido até que o problema seja resolvido.

Notificações via Webhook

Para configurar um novo webhook para notificações, utilize o endpoint set-accounts-webhook disponível nesta documentação.

Opções de Cadastro de Cliente

Durante o cadastro, o cliente pode escolher entre três modalidades de conta, conforme seu perfil:

Pessoa Física (PF) — Cadastro de indivíduos, com base no CPF e documentos pessoais.

Pessoa Jurídica (PJ) — Cadastro de empresas, incluindo documentos como o Contrato Social e outros dados corporativos.

O processo de aprovação varia de acordo com o tipo de cadastro e as informações fornecidas. Recomendamos que todos os dados sejam preenchidos corretamente para evitar atrasos ou rejeições no KYC. Caso haja rejeição, é possível reenviar os dados corrigidos para nova análise.

Regras Gerais

Campos em comum

Campo	Tipo	Descrição	Regras
`name`	`string`	Nome completo do titular da conta.	Obrigatório.
`taxid_number`	`string`	Número de CPF ou CNPJ do cliente.	Obrigatório. Deve ser único no sistema e seguir o formato de CPF ou CNPJ.
`mobile_phone`	`string`	Número de telefone celular do cliente.	Obrigatório.
`mobile_phone_country`	`string`	Código do país do telefone celular.	Obrigatório. Validado com a enumeração `CountryEnum`.
`email`	`string`	Endereço de e-mail do cliente.	Obrigatório. Deve ser um e-mail válido.
`address`	`array`	Informações de endereço.	Obrigatório.
`address.street`	`string`	Nome da rua.	Obrigatório.
`address.number`	`string`	Número da residência.	Obrigatório.
`address.complement`	`string`	Complemento do endereço.	Opcional.
`address.district`	`string`	Bairro.	Obrigatório.
`address.city`	`string`	Cidade.	Obrigatório.
`address.state`	`string`	Estado.	Obrigatório.
`address.zip_code`	`string`	CEP.	Obrigatório.
`address.country`	`string`	País.	Obrigatório. Validado com a enumeração `CountryEnum`.
`documents`	`array`	Lista de documentos enviados.	Obrigatório.
`documents.*.type`	`string`	Tipo do documento.	Obrigatório. Validado com a enumeração `DocumentsTypeEnum`.
`documents.*.content`	`string`	Conteúdo do documento codificado em Base64.	Obrigatório.
`custom_data`	`array`	Dados personalizados que podem ser enviados como informações adicionais.	Opcional.
`custom_data.latitude`	`string`	Latitude.	Opcional.
`custom_data.longitude`	`string`	Longitude.	Opcional.

Pessoa Física

Campo	Tipo	Descrição	Regras
`physical_detail`	`array`	Detalhes físicos da pessoa.	Obrigatório.
`physical_detail.social_name`	`string`	Nome social.	Opcional.
`physical_detail.father_name`	`string`	Nome do pai.	Opcional.
`physical_detail.mother_name`	`string`	Nome da mãe.	Obrigatório.
`physical_detail.birth_date`	`date`	Data de nascimento.	Obrigatório.
`physical_detail.birth_city`	`string`	Cidade de nascimento.	Obrigatório.
`physical_detail.birth_state`	`string`	Estado de nascimento.	Obrigatório.
`physical_detail.birth_country`	`string`	País de nascimento.	Obrigatório. Validado com a enumeração `CountryEnum`.
`physical_detail.business_line`	`integer`	Ocupação.	Obrigatório. Validado com a enumeração `PhysicalBusinessLineEnum`.
`physical_detail.document_type`	`string`	Tipo de documento de identificação.	Obrigatório.
`physical_detail.document_number`	`string`	Número do documento de identificação.	Obrigatório.
`physical_detail.document_issue_date`	`date`	Data de emissão do documento.	Obrigatório.
`physical_detail.document_issuer`	`string`	Órgão emissor do documento.	Obrigatório.
`physical_detail.document_state`	`string`	Estado emissor do documento.	Obrigatório.
`physical_detail.marital_status`	`string`	Estado civil.	Obrigatório. Validado com a enumeração `MaritalStatusEnum`.
`physical_detail.gender`	`string`	Gênero.	Obrigatório. Deve ser 'M' ou 'F'.
`physical_detail.financial_statistic`	`integer`	Ramo de atividade	Opcional. Validado com a enumeração `FinancialStatisticEnum`.
`physical_detail.monthly_income`	`numeric`	Renda mensal.	Obrigatório.

Campos para Responsável Legal (PF)

Campo	Tipo	Descrição	Regras
`physical_legal_responsible`	`array`	Informações do responsável legal, caso aplicável.	Opcional, mas obrigatório se presente.
`physical_legal_responsible.name`	`string`	Nome do responsável legal.	Obrigatório.
`physical_legal_responsible.mother_name`	`string`	Nome da mãe do responsável legal.	Obrigatório.
`physical_legal_responsible.taxid_number`	`string`	CPF ou CNPJ do responsável legal.	Obrigatório.
`physical_legal_responsible.mobile_phone`	`string`	Telefone celular do responsável legal.	Obrigatório.
`physical_legal_responsible.mobile_phone_country`	`string`	Código do país do telefone celular.	Obrigatório.
`physical_legal_responsible.email`	`string`	E-mail do responsável legal.	Obrigatório.
`physical_legal_responsible.birth_date`	`date`	Data de nascimento do responsável.	Obrigatório.
`physical_legal_responsible.documents`	`array`	Documentos do responsável legal.	Obrigatório.
`physical_legal_responsible.address`	`array`	Endereço do responsável legal.	Obrigatório.

Pessoa Jurídica

Campo	Tipo	Descrição	Regras
`legal_detail`	`array`	Detalhes legais da empresa.	Obrigatório.
`legal_detail.company_name`	`string`	Nome da empresa.	Obrigatório.
`legal_detail.business_line`	`string`	Ramo de atividade	Obrigatório. Validado com a enumeração `LegalBusinessLineEnum`.
`legal_detail.establishment_form`	`string`	Forma de constituição	Obrigatório. Validado com a enumeração `EstablishmentFormEnum`.
`legal_detail.establishment_date`	`date`	Data de constituição da empresa.	Obrigatório.
`legal_detail.state_registration`	`string`	Inscrição estadual.	Obrigatório.
`legal_detail.financial_statistic`	`numeric`	Setor de atividade	Obrigatório. Validado com a enumeração `FinancialStatisticEnum`.
`legal_detail.monthly_income`	`numeric`	Renda mensal.	Opcional.
`legal_representatives`	`array`	Lista de representantes legais da empresa.	Obrigatório.
`legal_representatives.*.name`	`string`	Nome do representante legal.	Obrigatório.
`legal_representatives.*.mother_name`	`string`	Nome da mãe do representante legal.	Obrigatório.
`legal_representatives.*.taxid_number`	`string`	CPF ou CNPJ do representante legal.	Obrigatório.
`legal_representatives.*.mobile_phone`	`string`	Telefone celular do representante legal.	Obrigatório.
`legal_representatives.*.email`	`string`	E-mail do representante legal.	Obrigatório.
`legal_representatives.*.birth_date`	`date`	Data de nascimento do representante legal.	Obrigatório.
`legal_representatives.*.documents`	`array`	Documentos do representante legal.

Modelos de Payload

Payload para Pessoa Física

{
  "name": "João Silva",
  "taxid_number": "12345678909",
  "mobile_phone": "11987654321",
  "mobile_phone_country": "BRA",
  "email": "joao.silva@example.com",
  "address": {
    "street": "Rua das Flores",
    "number": "123",
    "complement": "Apto 101",
    "district": "Centro",
    "city": "São Paulo",
    "state": "SP",
    "zip_code": "01010-010",
    "country": "BRA"
  },
  "documents": [
    {
      "type": "drivers_license",
      "content": "base64encodeddocumentcontent=="
    }
  ],
  "custom_data": {
    "longitude": "12123",
    "latitude": 12345,
    "device": "111111"
  },
  "physical_detail": {
    "social_name": "Joãozinho",
    "father_name": "Carlos Silva",
    "mother_name": "Maria Silva",
    "birth_date": "1990-01-01",
    "birth_city": "São Paulo",
    "birth_state": "SP",
    "birth_country": "BRA",
    "occupation": 1,
    "document_type": "RG",
    "document_number": "123456789",
    "document_issue_date": "2010-01-01",
    "document_issuer": "SSP-SP",
    "document_state": "SP",
    "marital_status": "single",
    "gender": "M",
    "financial_statistic": 4500,
    "monthly_income": 3000
  }
}

Payload para Pessoa Fisica (Responsável Legal)

Payload para Pessoa Jurídica

create-description

Fluxo de Cadastro e KYC#

Status da Conta#

Notificações via Webhook#

Opções de Cadastro de Cliente#

Regras Gerais#

Campos para Responsável Legal (PF)#