Skip to main content

Processo de Onboarding KYC

Visão Geral

O onboarding KYC é uma etapa de validação cadastral utilizada para verificar se uma pessoa física ou jurídica está apta a seguir no processo de proposta no nosso sistema. Quando essa validação estiver habilitada para o produto contratado, o nosso sistema verifica se a pessoa já concluiu o onboarding e qual foi o resultado da análise.

Fluxo do Processo

Etapas

  1. A pessoa é incluída pela API pessoa/salvar.
  2. Em paralelo, os dados da pessoa são enviados ao Origem, responsável pela análise KYC.
  3. O Origem executa a análise cadastral.
  4. O resultado da análise é recebido pelo nosso sistema.
  5. Durante a inclusão da proposta, as APIs consultam o resultado do onboarding.
  6. Com base nesse resultado, a proposta é liberada para continuar ou bloqueada.

Possíveis Resultados

Importante A aprovação no onboarding não garante a aprovação da proposta. Outras validações de negócio continuam sendo executadas normalmente.

Quando a Proposta Pode Ser Bloqueada

A proposta poderá ser bloqueada quando:
  • o onboarding for obrigatório para o produto; e
  • a pessoa não possuir um resultado aprovado no momento da inclusão da proposta.
Isso ocorre quando:
  • a análise ainda não foi concluída; ou
  • a pessoa foi reprovada conforme as políticas internas aplicáveis.

Observações

  • A validação de onboarding somente é aplicada quando estiver habilitada para o produto.
  • As mensagens apresentadas ao usuário são genéricas por razões regulatórias e de política interna.
  • A aprovação do onboarding não substitui as demais validações executadas durante o processo de proposta.

Testes em Ambiente de Homologação

Para facilitar a homologação das integrações, o ambiente de homologação permite simular os possíveis resultados da análise KYC sem depender da conclusão do processo real. Para isso, basta enviar um CPF ou CNPJ válido cujo primeiro dígito determine o resultado esperado.
Importante Esse comportamento está disponível apenas no ambiente de homologação com configuração de onboarding ativa e não se aplica ao ambiente de produção.

Resultados Simulados

Observações

  • O documento informado deve possuir um CPF ou CNPJ válido.
  • Apenas o primeiro dígito é utilizado para definir o resultado da simulação.

Callback de Resultado do Onboarding

Quando o callback estiver configurado para o parceiro, após a conclusão da análise KYC será enviada uma notificação contendo o resultado do onboarding. O payload enviado possui o seguinte formato: