Guia do Desenvolvedor para Fluxos de Fallback Dinâmicos em APIs de IDV (PT-BR)

Tratamento Proativo de Erros Implemente tratamento de erros robusto e mecanismos de nova tentativa em suas integrações de API IDV para evitar que falhas de verificação impactem a experiência do usuário.

Verificação Multicamadas Desenvolva fluxos de trabalho que incorporem múltiplos métodos de verificação, permitindo transições contínuas para verificações alternativas caso um método primário falhe ou produza resultados inconclusivos.

Experiência do Usuário Otimizada Utilize fallbacks dinâmicos para guiar os usuários por caminhos de verificação alternativos, minimizando o atrito e garantindo um onboarding ou conclusão de transação bem-sucedidos.

Fluxos de Trabalho Orquestrados da Didit Aproveite a plataforma modular e nativa de IA da Didit para construir e gerenciar fluxos de trabalho de fallback dinâmicos e complexos com um construtor visual sem código ou APIs limpas, garantindo máxima flexibilidade e confiabilidade.

A Importância dos Fluxos de Fallback Dinâmicos em IDV

No mundo da verificação de identidade online, depender de uma única chamada de API para confirmar a identidade de um usuário é uma receita para falhas potenciais e uma experiência de usuário insatisfatória. Fatores como baixa 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 atrapalhar o processo de verificação. É aqui que os fluxos de fallback dinâmicos se tornam indispensáveis. Uma estratégia de fallback bem projetada garante que, se um método de verificação primário falhar, o sistema possa inteligentemente mudar para uma alternativa, mantendo a jornada do usuário fluida e as taxas de sucesso de verificação altas. 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 desenvolvedores, construir sistemas resilientes significa antecipar falhas e ter um plano B, C e até D. Fluxos de verificação estáticos e rígidos geralmente levam os usuários a abandonar o processo ao encontrar um erro. Os fallbacks dinâmicos, por outro lado, oferecem flexibilidade, permitindo que as empresas se adaptem às condições em tempo real e à entrada do usuário. Isso é particularmente crítico para aplicativos que envolvem processos sensíveis como onboarding de clientes, verificação de idade para conteúdo regulamentado ou transações de alto valor onde uma robusta garantia de identidade é primordial.

Projetando Lógicas de Fallback Eficazes

A implementação de fluxos de fallback dinâmicos requer planejamento cuidadoso e uma compreensão profunda de suas necessidades de verificação. A ideia central é definir uma sequência de etapas de verificação e lógica condicional que dita o fluxo com base no resultado de cada etapa. Veja como abordar isso:

1. Identifique Pontos de Falha Potenciais

Antes de projetar fallbacks, você precisa saber o que pode dar errado. Pontos de falha comuns em IDV incluem:

• Problemas na Digitalização de Documentos: Imagens borradas, reflexos, tipo de documento incorreto ou documentos expirados podem levar a falhas na Verificação de ID (OCR, MRZ, códigos de barras).
• Falhas na Detecção de Liveness: Usuários que falham nas verificações de liveness devido a má iluminação, deepfakes ou não conformidade com as instruções.
• Incompatibilidades no Face Match: 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 registros do banco de dados ou aos dados fornecidos pelo usuário.
• Sinalizações de Triagem AML: Um usuário aparecendo em uma lista de observação que exige revisão manual adicional.
• Interrupções do Serviço de API: Indisponibilidade temporária ou erros de um provedor de verificação de identidade.

2. Defina Lógicas Condicionais e Caminhos Alternativos

Uma vez identificados os pontos de falha, mapeie os caminhos alternativos. Por exemplo:

• Se uma Verificação de ID inicial (OCR) falhar devido à baixa qualidade da imagem, peça ao usuário para tirar a foto novamente ou mudar para um tipo de documento diferente.
• Se a detecção de Liveness Passiva e Ativa indicar um alto risco de fraude, acione uma revisão manual ou solicite provas adicionais, como Comprovante de Endereço.
• Se um Face Match 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 em conhecimento.
• Para cenários de verificação de idade, se a Estimativa de Idade for inconclusiva, peça uma digitalização de ID física.
• Se uma verificação de Triagem e Monitoramento AML retornar uma correspondência potencial, encaminhe automaticamente o usuário para um oficial de conformidade para investigação adicional sem interromper o fluxo do usuário.

Os Fluxos de Trabalho Orquestrados da Didit, acessíveis via seu Console de Negócios sem código, são projetados precisamente para isso, permitindo que você construa visualmente árvores de decisão complexas e etapas condicionais sem escrever uma única linha de código. Essa abordagem modular significa que você pode misturar e combinar verificações de identidade e definir facilmente limites para sucesso ou falha.

3. Priorize a Experiência do Usuário

Os fallbacks não devem parecer uma punição. O objetivo é manter o usuário engajado e reduzir o atrito. Forneça instruções claras e concisas quando um fallback for acionado. Por exemplo, em vez de um erro genérico, diga ao usuário: "A foto do seu documento estava borrada. Por favor, tente novamente em uma área bem iluminada." ou "Não conseguimos confirmar sua identidade com este método. Gostaria de tentar verificar com um documento diferente ou entrar em contato com o suporte?" Minimizar o número de etapas e garantir uma UI/UX consistente em todos os caminhos de verificação é crucial.

Estratégias Técnicas de Implementação

Do ponto de vista técnico, a implementação de fluxos de fallback dinâmicos envolve várias considerações importantes:

1. Orquestração de API e Gerenciamento de Estado

Seu sistema de backend precisa orquestrar chamadas para várias APIs de IDV e gerenciar o estado do processo de verificação. Isso inclui rastrear quais etapas foram concluídas, quais falharam e quais caminhos de fallback foram iniciados. A abordagem API-first da Didit e o uso de 'sessões' simplificam isso. Ao criar uma sessão com um ID de fluxo de trabalho específico, a Didit lida com toda a experiência voltada para o usuário, gerenciamento de estado e etapas condicionais. Você só precisa consultar o status 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
        - LIVENESS
        - FACE_MATCH
    - uuid: b2c3d4e5-6789-01bc-defg-222222222222
      workflow_label: Verificação Completa + AML
      workflow_type: kyc
      features:
        - OCR
        - LIVENESS
        - FACE_MATCH
        - AML

Este exemplo de API mostra como diferentes fluxos de trabalho, cada um com recursos distintos como OCR, Liveness, Face Match e AML, podem ser definidos e acessados. Você pode então selecionar dinamicamente o fluxo de trabalho apropriado com base nos resultados da verificação inicial ou na demografia do usuário.

2. Cliente de API Robusto e Tratamento de Erros

Seu cliente de API deve ser construído para lidar com vários códigos de status HTTP e respostas de erro de forma elegante. Implemente mecanismos de nova tentativa com backoff 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 novas tentativas desnecessárias. Registre todas as interações da API e respostas de erro de forma completa 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 ID, Liveness, Face Match, Triagem AML, Comprovante de Endereço, Estimativa de Idade, Verificação de Telefone e E-mail) é um componente distinto e plug-and-play. Isso permite que você 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 via APIs limpas, tornando mais fácil criar fluxos de trabalho personalizados.

Como a Didit Ajuda

A Didit é projetada desde o início para capacitar desenvolvedores com as ferramentas para construir fluxos de trabalho de verificação de identidade sofisticados e dinâmicos. Nossa plataforma nativa de IA, focada no desenvolvedor, oferece uma camada de identidade aberta e modular que simplifica a implementação de fallbacks e jornadas de verificação complexas.

• Fluxos de Trabalho Orquestrados: O construtor visual sem código da Didit no Business Console permite que você projete fluxos de verificação de identidade em várias etapas, incluindo nós de lógica condicional para KYC, verificações de idade e triagem AML. Você define a lógica uma vez, e a Didit lida com a experiência voltada para o usuário, gerenciamento de estado e etapas condicionais. Isso significa que você pode configurar facilmente métodos primários e de fallback, como começar com Verificação de ID (OCR) e Liveness, e se um limite não for atingido, acionar automaticamente uma solicitação de Comprovante de Endereço ou revisão manual.
• Conjunto Abrangente de Produtos: Com a Didit, você tem acesso a um espectro completo de ferramentas de verificação, incluindo Verificação de ID (OCR, MRZ, códigos de barras), Liveness Passiva e Ativa, Face Match 1:1 e Busca Facial, Triagem e Monitoramento AML, Comprovante de Endereço, 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 que você construa praticamente qualquer cenário de fallback imaginável.
• Abordagem Focada no Desenvolvedor: A Didit oferece um sandbox instantâneo, documentação pública e APIs limpas, tornando a integração perfeita. Você pode listar, criar, atualizar e excluir fluxos de trabalho programaticamente, dando-lhe controle total sobre sua lógica de verificação.
• KYC Essencial Gratuito: A Didit oferece KYC Essencial Gratuito, permitindo que as empresas comecem e construam fluxos de trabalho robustos sem custos iniciais. Nosso modelo de pagamento por verificação bem-sucedida e sem taxas de configuração significa que você 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 os fallbacks são acionados.

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.