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
- A pessoa é incluída pela API
pessoa/salvar. - Em paralelo, os dados da pessoa são enviados ao Origem, responsável pela análise KYC.
- O Origem executa a análise cadastral.
- O resultado da análise é recebido pelo nosso sistema.
- Durante a inclusão da proposta, as APIs consultam o resultado do onboarding.
- 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.
- 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.

