Comece pelo cadastro que você precisa
KYC é uma jornada para conhecer e conferir informações do cliente. O fluxo depende do contexto: um cadastro de pessoa física não usa os mesmos documentos e dados de uma empresa. Defina o que precisa ser verificado antes de pedir arquivos.
Separe coleta, extração, comparação e decisão. Essa organização evita que um único resultado técnico seja interpretado como aprovação de todo o cadastro.
Componha as etapas da integração
- Leia os campos do documento de identidade com a API de documentos.
- Compare a foto do documento com a selfie usando Face Match.
- Se houver uma empresa no cadastro, consulte o CNPJ e a referência da base.
- Encaminhe divergências ou dados insuficientes para revisão.
Guarde o estado de cada etapa
Uma jornada pode parar por arquivo ilegível, erro de API ou divergência cadastral. Use estados diferentes para essas situações. Assim, o usuário recebe uma orientação concreta em vez de uma recusa genérica.
Associe as chamadas ao projeto e guarde os identificadores de execução necessários para investigação. Evite repetir imagens, documentos e dados pessoais nos logs da aplicação.
Teste a jornada completa
Comece com respostas simuladas em DEV e valide os caminhos de sucesso, erro e revisão. Em seguida, faça testes controlados com dados autorizados, incluindo reenvio de arquivo e interrupção no meio do cadastro.
Antes de operar, revise a finalidade do tratamento, as permissões, a retenção e as alternativas para quem não consegue concluir a captura. Uma integração tecnicamente correta também precisa de um processo compreensível para o usuário.
O próximo passo está na API.
Conheça os campos, os exemplos e as regras de cada serviço antes de integrar.
Conhecer a solução de onboarding
