Guia para Desenvolvedores: Fluxos de Trabalho de Contingência Dinâmicos para APIs de Verificação de Identidade (PT-PT)
Descubra como implementar fluxos de trabalho de contingência dinâmicos e robustos para APIs de Verificação de Identidade (IDV), melhorando a experiência do utilizador e garantindo altas taxas de sucesso.

Gestão Proativa de ErrosImplemente mecanismos robustos de gestão de erros e repetição dentro das suas integrações de API IDV para evitar que falhas na verificação afetem a experiência do utilizador.
Verificação Multi-camadasDesenhe fluxos de trabalho que incorporem múltiplos métodos de verificação, permitindo transições fluidas para verificações alternativas caso um método primário falhe ou produza resultados inconclusivos.
Experiência do Utilizador OtimizadaUtilize contingências dinâmicas para guiar os utilizadores por caminhos de verificação alternativos, minimizando a fricção e garantindo uma integração ou conclusão de transação bem-sucedida.
Fluxos de Trabalho Orquestrados da DiditAproveite a plataforma modular e nativa de IA da Didit para construir e gerir fluxos de trabalho de contingência dinâmicos e complexos com um construtor visual sem código ou APIs limpas, garantindo máxima flexibilidade e fiabilidade.
A Importância dos Fluxos de Trabalho de Contingência Dinâmicos na Verificação de Identidade
No mundo da verificação de identidade online, depender de uma única chamada de API para confirmar a identidade de um utilizador é uma receita para potenciais falhas e uma má experiência do utilizador. Fatores como má qualidade da imagem do documento, latência da rede, limites de taxa da API ou até mesmo interrupções temporárias do serviço podem perturbar o processo de verificação. É aqui que os fluxos de trabalho de contingência dinâmicos se tornam indispensáveis. Uma estratégia de contingência bem projetada garante que, se um método de verificação primário falhar, o sistema possa inteligentemente mudar para uma alternativa, mantendo o percurso do utilizador suave e mantendo altas taxas de sucesso na verificação. Isso não só melhora a satisfação do cliente, mas também impacta diretamente as taxas de conversão e a eficiência operacional.
Para os desenvolvdores, construir sistemas resilientes significa antecipar falhas e ter um plano B, C e até D. Fluxos de verificação estáticos e rígidos muitas vezes levam os utilizadores a abandonar o processo quando encontram um erro. As contingências dinâmicas, por outro lado, proporcionam flexibilidade, permitindo que as empresas se adaptem às condições em tempo real e à entrada do utilizador. Isso é particularmente crítico para aplicações que envolvem processos sensíveis como a integração de clientes, verificação de idade para conteúdo regulado ou transações de alto valor onde a garantia de identidade robusta é primordial.
Projetar Lógica de Contingência Eficaz
A implementação de fluxos de trabalho de contingência dinâmicos requer um planeamento cuidadoso e uma compreensão profunda das suas necessidades de verificação. A ideia central é definir uma sequência de passos de verificação e lógica condicional que dita o fluxo com base no resultado de cada passo. Eis como abordá-lo:
1. Identificar Potenciais Pontos de Falha
Antes de projetar as contingências, precisa de saber o que pode correr mal. Os pontos de falha comuns na verificação de identidade incluem:
- Problemas de Leitura de Documentos: Imagens desfocadas, brilho, tipo de documento incorreto ou documentos expirados podem levar a falhas na Verificação de Identidade (OCR, MRZ, códigos de barras).
- Falhas na Deteção de Prova de Vida: Utilizadores que falham nas verificações de prova de vida devido a má iluminação, deepfakes ou não conformidade com as instruções.
- Incompatibilidades de Correspondência Facial: Discrepâncias entre a foto do documento e a selfie ao vivo.
- Incompatibilidades de Dados: Informações extraídas de um documento que não correspondem aos registos da base de dados ou dados fornecidos pelo utilizador.
- Sinalizadores de Triagem AML: Um utilizador que aparece numa lista de vigilância, exigindo uma revisão manual adicional.
- Interrupções de Serviço da API: Indisponibilidade temporária ou erros de um fornecedor de verificação de identidade.
2. Definir Lógica Condicional e Caminhos Alternativos
Uma vez identificados os pontos de falha, mapeie os caminhos alternativos. Por exemplo:
- Se uma Verificação de Identidade (OCR) inicial falhar devido a má qualidade da imagem, peça ao utilizador para tirar novamente a foto ou mudar para um tipo de documento diferente.
- Se a deteção de Prova de Vida Passiva e Ativa indicar um alto risco de fraude, desencadeie uma revisão manual ou solicite provas adicionais, como Comprovativo de Morada.
- Se uma Correspondência Facial 1:1 falhar, talvez ofereça uma alternativa como Verificação de Telefone e E-mail combinada com perguntas específicas de autenticação baseadas no conhecimento.
- Para cenários de verificação de idade, se a Estimativa de Idade for inconclusiva, peça uma leitura de identificação física.
- Se uma verificação de Triagem e Monitorização AML retornar uma correspondência potencial, encaminhe automaticamente o utilizador para um oficial de conformidade para uma investigação adicional sem interromper o fluxo do utilizador.
Os Fluxos de Trabalho Orquestrados da Didit, acessíveis através da sua Consola de Negócios sem código, são projetados precisamente para isso, permitindo-lhe construir visualmente árvores de decisão complexas e passos condicionais sem escrever uma única linha de código. Esta abordagem modular significa que pode misturar e combinar verificações de identidade e definir facilmente limiares para sucesso ou falha.
3. Priorizar a Experiência do Utilizador
As contingências não devem parecer um castigo. O objetivo é manter o utilizador envolvido e reduzir a fricção. Forneça instruções claras e concisas quando uma contingência é acionada. Por exemplo, em vez de um erro genérico, diga ao utilizador: "A foto do seu documento estava desfocada. Por favor, tente novamente numa área bem iluminada." ou "Não conseguimos confirmar a sua identidade com este método. Gostaria de tentar verificar com um documento diferente ou contactar o suporte?" Minimizar o número de passos e garantir uma UI/UX consistente em todos os caminhos de verificação é crucial.
Estratégias de Implementação Técnica
Do ponto de vista técnico, a implementação de fluxos de trabalho de contingência dinâmicos envolve várias considerações chave:
1. Orquestração de APIs e Gestão de Estado
O seu sistema de backend precisa de orquestrar chamadas para várias APIs de verificação de identidade e gerir o estado do processo de verificação. Isso inclui o acompanhamento dos passos concluídos, dos que falharam e dos caminhos de contingência iniciados. A abordagem API-first da Didit e o uso de 'sessões' simplificam isso. Quando cria uma sessão com um ID de fluxo de trabalho específico, a Didit gere toda a experiência do utilizador, gestão de estado e passos condicionais. Só precisa de consultar o estado da sessão para saber o resultado.
GET /v3/workflows/
- uuid: a1b2c3d4-5678-90ab-cdef-111111111111
workflow_label: KYC Padrão
workflow_type: kyc
features:
- OCR
- PROVA_DE_VIDA
- CORRESPONDENCIA_FACIAL
- uuid: b2c3d4e5-6789-01bc-defg-222222222222
workflow_label: Verificação Completa + AML
workflow_type: kyc
features:
- OCR
- PROVA_DE_VIDA
- CORRESPONDENCIA_FACIAL
- AML
Este exemplo de API mostra como diferentes fluxos de trabalho, cada um com características distintas como OCR, Prova de Vida, Correspondência Facial e AML, podem ser definidos e acedidos. Pode então selecionar dinamicamente o fluxo de trabalho apropriado com base nos resultados da verificação inicial ou na demografia do utilizador.
2. Cliente API Robusto e Gestão de Erros
O seu cliente API deve ser construído para lidar com vários códigos de estado HTTP e respostas de erro de forma graciosa. Implemente mecanismos de repetição com recuo exponencial para erros transitórios. Diferencie entre erros transitórios (por exemplo, problemas de rede) e erros permanentes (por exemplo, entrada inválida) para evitar repetições desnecessárias. Registe todas as interações da API e respostas de erro de forma exaustiva para fins de depuração e auditoria.
3. Verificações de Identidade Modulares e Componíveis
Adote uma arquitetura modular onde cada verificação de identidade (Verificação de Identidade, Prova de Vida, Correspondência Facial, Triagem AML, Comprovativo de Morada, Estimativa de Idade, Verificação de Telefone e E-mail) é um componente distinto e "plug-and-play". Isso permite que troque ou adicione facilmente novos métodos de verificação sem re-arquitetar todo o seu sistema. A plataforma da Didit é construída com base neste princípio, oferecendo primitivas de identidade componíveis através de APIs limpas, facilitando a criação de fluxos de trabalho personalizados.
Como a Didit Ajuda
A Didit foi projetada desde o início para capacitar os desenvolvedores com as ferramentas para construir fluxos de trabalho de verificação de identidade sofisticados e dinâmicos. A nossa plataforma nativa de IA, focada no desenvolvedor, oferece uma camada de identidade aberta e modular que simplifica a implementação de contingências e percursos de verificação complexos.
- Fluxos de Trabalho Orquestrados: O construtor visual sem código da Didit na Consola de Negócios permite-lhe projetar fluxos de verificação de identidade multi-passos, incluindo nós de lógica condicional para KYC, verificações de idade e triagem AML. Define a lógica uma vez, e a Didit gere a experiência do utilizador, a gestão de estado e os passos condicionais. Isso significa que pode facilmente configurar métodos primários e de contingência, como começar com Verificação de Identidade (OCR) e Prova de Vida, e se um limiar não for atingido, acionar automaticamente um pedido de Comprovativo de Morada ou revisão manual.
- Conjunto Abrangente de Produtos: Com a Didit, tem acesso a um espetro completo de ferramentas de verificação, incluindo Verificação de Identidade (OCR, MRZ, códigos de barras), Prova de Vida Passiva e Ativa, Correspondência Facial 1:1 e Pesquisa Facial, Triagem e Monitorização AML, Comprovativo de Morada, Estimativa de Idade (preservando a privacidade), Verificação de Telefone e E-mail, e Verificação NFC (ePassaporte/eID). Este extenso conjunto de ferramentas permite-lhe construir praticamente qualquer cenário de contingência imaginável.
- Abordagem Focada no Desenvolvedor: A Didit oferece um ambiente de testes instantâneo, documentação pública e APIs limpas, tornando a integração perfeita. Pode listar, criar, atualizar e eliminar fluxos de trabalho programaticamente, dando-lhe controlo total sobre a sua lógica de verificação.
- KYC Essencial Gratuito: A Didit oferece um KYC Essencial Gratuito, permitindo que as empresas comecem e construam fluxos de trabalho robustos sem custos iniciais. O nosso modelo de pagamento por verificação bem-sucedida e sem taxas de configuração significa que só paga quando a verificação é bem-sucedida, alinhando os custos com o valor.
- Automação Nativa de IA: Ao alavancar a IA, a Didit automatiza grande parte do processo de tomada de decisão dentro dos fluxos de trabalho, reduzindo a necessidade de revisão manual e acelerando os tempos de verificação, mesmo quando as contingências são ativadas.
Pronto para Começar?
Pronto para ver a Didit em ação? Obtenha uma demonstração gratuita hoje.
Comece a verificar identidades gratuitamente com o nível gratuito da Didit.