Testes E2E Automatizados para Fluxos de Identidade: Cypress e Didit (PT-BR)
Aprenda a implementar testes robustos de ponta a ponta para seus fluxos de verificação de identidade usando Cypress e o ambiente sandbox focado em desenvolvedores da Didit, garantindo segurança e conformidade.

Otimize Testes com o Sandbox DiditO Didit oferece um ambiente sandbox focado no desenvolvedor, permitindo simular cenários reais de verificação de identidade sem impactar a produção ou gerar custos, tornando-o ideal para testes E2E automatizados.
Cypress para Cobertura E2E AbrangenteO Cypress oferece um framework rápido, confiável e amigável para desenvolvedores, ideal para escrever testes de ponta a ponta que interagem diretamente com a UI da sua aplicação, incluindo fluxos complexos de verificação de identidade.
Automatize a Validação de Fluxos de IdentidadeAo combinar o Cypress com a API do Didit, você pode criar sessões de teste programaticamente, acionar vários resultados de verificação e garantir que sua aplicação lida corretamente com cada cenário, desde KYC bem-sucedido até rejeições.
A Arquitetura Modular do Didit Aprimora a TestabilidadeA plataforma de identidade aberta e modular do Didit permite testes granulares de etapas de verificação individuais, como Verificação de ID ou Prova de Vida, e depois integrá-las em fluxos orquestrados, garantindo que cada componente funcione perfeitamente.
O Desafio de Testar Fluxos de Identidade
Os fluxos de verificação de identidade são componentes críticos em aplicações modernas, protegendo contra fraudes e garantindo conformidade. No entanto, sua natureza multifacetada, dependência de serviços externos e resultados variáveis os tornam notoriamente difíceis de testar de forma abrangente. Testes manuais são lentos, propensos a erros e não escalam. Testes automatizados de ponta a ponta (E2E) são essenciais para garantir uma experiência de usuário suave, segura e confiável, mas exigem uma abordagem estratégica, especialmente ao lidar com provedores de identidade de terceiros.
Os testes tradicionais frequentemente enfrentam dificuldades para simular cenários do mundo real para verificação de ID, checagens de prova de vida ou triagem AML sem incorrer em custos ou depender de sistemas externos lentos e inconsistentes. É aqui que uma plataforma de identidade focada no desenvolvedor como o Didit, combinada com uma poderosa ferramenta de teste E2E como o Cypress, se torna inestimável. Ao aproveitar o ambiente sandbox do Didit e suas APIs limpas, os desenvolvedores podem simular um espectro completo de resultados de verificação de identidade, garantindo que cada caso de uso seja coberto sem comprometer.
Configurando Seu Ambiente de Teste E2E com Cypress
Cypress é uma ferramenta de teste front-end de próxima geração construída para a web moderna. Ele oferece uma arquitetura única que executa testes diretamente no navegador, proporcionando execução rápida, recarregamento em tempo real e excelentes capacidades de depuração. Para começar, você precisará instalar o Cypress em seu projeto:
npm install cypress --save-dev
npx cypress open
Uma vez instalado, o Cypress criará uma pasta cypress com exemplos de testes. Para fluxos de identidade, você normalmente interage com a UI da sua aplicação para iniciar uma sessão de verificação e, em seguida, potencialmente interage com a API do Didit para controlar ou consultar o status da sessão. O Cypress permite que você escreva testes que:
- Naveguem para sua página de onboarding ou verificação.
- Preencham formulários e cliquem em botões.
- Interceptem requisições de rede para simular respostas da API (embora para o Didit, muitas vezes preferiremos chamadas de API reais para o sandbox).
- Verifiquem elementos da UI e seus estados após os resultados da verificação.
Integrando o Sandbox do Didit para Cenários Realistas
O Didit foi projetado pensando nos desenvolvedores, oferecendo uma plataforma de identidade modular e nativa de IA. Uma vantagem chave para testes é seu robusto ambiente sandbox. Isso permite que você realize fluxos completos de verificação de identidade – incluindo Verificação de ID (OCR, MRZ, códigos de barras), Prova de Vida Passiva e Ativa, Correspondência Facial 1:1 e Triagem e Monitoramento AML – sem usar dados de usuários reais ou incorrer em custos de produção. Você pode acionar resultados específicos (por exemplo, aprovado, recusado, em revisão) usando o sandbox, tornando seus testes E2E incrivelmente poderosos e previsíveis.
Quando você cria um fluxo de trabalho do Didit em seu Console de Negócios, você obtém um workflow_id. Para testes, você usará este workflow_id em conjunto com sua Chave de API do Didit (na seção 'API & Webhooks' em seu console) para criar sessões de verificação programaticamente dentro de seus testes Cypress. Isso permite que você:
- Inicie Sessões: Use a API do Didit para criar uma sessão de verificação, recuperando a
verification_urlpara redirecionar seu navegador Cypress. - Simule Ações do Usuário: Dentro do Cypress, navegue pelo fluxo de verificação hospedado pelo Didit, simulando uploads de documentos, checagens de prova de vida, etc.
- Controle Resultados (Sandbox): Em um ambiente sandbox, você pode frequentemente usar dados de teste ou parâmetros específicos para forçar um resultado particular (por exemplo, uma imagem de documento específica para um resultado 'aprovado', ou uma imagem fraudulenta conhecida para 'recusado').
- Recupere Resultados: Após o usuário completar o fluxo (ou ele ser abandonado/recusado), use a API do Didit novamente para recuperar o status da sessão e os resultados detalhados.
Automatizando a Validação de Fluxos de Identidade com Didit e Cypress
O verdadeiro poder vem da combinação das capacidades de interação da UI do Cypress com a API do Didit para gerenciamento de sessões. Considere um caso de teste onde um usuário completa um fluxo KYC com sucesso:
- Um teste Cypress começa: Seu teste navega para a página de login/cadastro da sua aplicação.
- Acione a sessão Didit: Sua aplicação, ou o próprio teste Cypress (via
cy.request), faz uma chamada de API para o Didit para criar uma sessão de verificação usando umworkflow_idespecífico configurado para seu sandbox. - Redirecione para o Didit: Sua aplicação redireciona o usuário (e, portanto, o Cypress) para a
verification_urlretornada pelo Didit. - Complete a verificação: O Cypress interage com o fluxo hospedado pelo Didit, simulando uploads de documentos e checagens de prova de vida. Dentro do sandbox, você pode usar imagens ou dados de teste predefinidos para garantir um resultado bem-sucedido.
- Retorne para seu aplicativo: Após a conclusão, o Didit redireciona de volta para a URL de callback da sua aplicação.
- Verifique o estado da aplicação: O Cypress afirma que a UI da sua aplicação reflete a verificação bem-sucedida (por exemplo, um status 'Verificado', acesso a recursos restritos).
- Limpeza pós-teste: Opcionalmente, seu teste pode chamar a API do Didit para buscar os detalhes completos da sessão (dados de ID, pontuações de prova de vida, resultados AML) e afirmar que os dados retornados correspondem às expectativas.
Essa abordagem permite testes robustos tanto da sua integração com o Didit quanto do tratamento de sua aplicação para vários estados de verificação. A arquitetura modular do Didit significa que você pode testar componentes individuais como Verificação de ID, Prova de Vida Passiva e Ativa, ou Triagem e Monitoramento AML isoladamente, e depois combiná-los em fluxos de trabalho complexos, garantindo cobertura abrangente.
Como o Didit Ajuda
O Didit é projetado para simplificar a verificação de identidade e, por extensão, seus testes. Nossa arquitetura modular e abordagem focada no desenvolvedor são perfeitamente adequadas para testes E2E automatizados com ferramentas como o Cypress. O Didit oferece:
- KYC Básico Gratuito: Nosso generoso plano gratuito permite testes extensivos sem preocupações com custos, especialmente em ambientes sandbox.
- APIs e Sandbox Focados no Desenvolvedor: Ambientes sandbox provisionados instantaneamente e APIs limpas permitem controle programático sobre as sessões de verificação, facilitando a criação, gerenciamento e consulta de sessões de teste.
- Fluxos de Trabalho Orquestrados: Projete jornadas de identidade complexas (KYC, verificações de idade, AML) em nosso Console de Negócios sem código, e depois teste-as de ponta a ponta. Você pode recuperar
workflow_ids da API para usar em seus testes. - Dados de Identidade Estruturados: Após uma sessão, recupere dados abrangentes e estruturados, incluindo resultados de Verificação de ID, pontuações de Prova de Vida, Correspondência Facial 1:1 e resultados de Triagem AML, tornando as afirmações em seus testes diretas.
- Global por Design: Teste seus fluxos de trabalho em diferentes tipos de documentos e regiões, garantindo que sua aplicação esteja pronta para uma base de usuários global.
Ao usar o Didit, você pode se concentrar na construção dos recursos centrais da sua aplicação, confiante de que seus fluxos de verificação de identidade são completamente testados e confiáveis. Nossa plataforma nativa de IA garante precisão, enquanto nossa arquitetura flexível garante testabilidade.
Pronto para Começar?
Pronto para ver o Didit em ação? Obtenha uma demonstração gratuita hoje mesmo.
Comece a verificar identidades gratuitamente com o plano gratuito do Didit.