Pular para o conteúdo principal

​
Processo de Onboarding KYC

​
Visão Geral

O onboarding KYC é uma etapa de validação cadastral utilizada para verificar se o tomador está apto a seguir no processo de inclusão da proposta. 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 por meio da API pessoa/salvar.
  2. Em paralelo, os dados da pessoa são encaminhados ao motor interno de KYC, responsável pelo enriquecimento cadastral, pela validação das informações e pela classificação de risco do cadastro.
  3. O resultado da análise é recebido pelo nosso sistema.
  4. Durante a inclusão da proposta, as APIs consultam o resultado do onboarding.
  5. Com o retorno de callback aprovado, o fluxo é liberado para a inclusão da proposta por meio do endpoint /FGTS/IncluirProposta.
  6. Caso não haja retorno com callback aprovado, a tentativa de inclusão da proposta pelo endpoint correspondente retornará erro HTTP 400.

​
Possíveis Resultados

​
Cadastro aprovado

Quando o cadastro estiver aprovado, a chamada ao endpoint de inclusão da proposta será liberada, sem aplicação de bloqueios, e o callback retornará success. O cadastro aprovado segue sem restrições para o próximo evento do fluxo (inclusão da proposta).

​
Onboarding não concluído

Quando o onboarding do cadastro ainda não estiver concluído, será retornado:

​
Cadastro reprovado

Quando o cadastro tiver sido reprovado, o campo motivo retornará o detalhamento. Documento com marcações de fraude: reprovado quando há marcações no DICT ou Rufra (Resolução Conjunta n6/BCB)
Divergência entre dados informados e dados enriquecidos: Quando houver divergência entre os dados fornecidos no cadastro e as informações enriquecidas pelos bureaus. Neste caso, nova requisição de cadastro e emissão do contrato deve ser realizado com os campos corrigidos.
Os campos divergentes serão identificados na mensagem de retorno. Reprovação por Políticas Internas: quando, para atendimento à Carta Circular 3978 e em respeito ao apetite de risco da BMP, o cadastro é reprovado.

​
Quando a Proposta Pode Ser Bloqueada

A inclusão da proposta poderá ser bloqueada quando a pessoa não possuir um resultado de onboarding aprovado no momento da solicitação. Isso pode ocorrer em duas situações:
  • Análise em andamento: o processo de análise cadastral ainda não foi concluído.
  • Cadastro reprovado: o resultado da análise cadastral foi desfavorável.
Nessas situações, a tentativa de inclusão da proposta retornará erro HTTP 400, conforme o motivo correspondente. Para identificar o resultado da análise e o motivo do bloqueio, consulte os retornos disponibilizados via callback.

​
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.
Baixar Cartilha KYC para Parceiros (PDF)

​
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.