Como testar e solucionar problemas de integração com o Toden
Charles Archibong, Cofundador
Teste a integração completa, incluindo falhas e recuperação. Escolha o fixture compatível com a família de APIs que você usa e, em seguida, inspecione o registro do Toden e o comportamento do seu aplicativo.
Pontos principais
- Todas as ramificações de decisão alcançam o caminho de aplicação pretendido.
- Respostas perdidas e eventos repetidos não criam efeito duplicado.
- Os termos "pendente" e "indisponível" permanecem distintos.
- Os jogos continuam explicitamente identificados.
- Alegações que se restringem à produção exigem comprovação presencial.
Teste a integração completa, incluindo falhas e recuperação. Escolha o dispositivo compatível para o API família que você usa, depois inspecione ambos Toden O histórico do aplicativo e seu comportamento.
Antes de começar
Um cenário Sandbox suportado ou amostra rotulada
Use a família de endpoints correta e SDK versão
Use um membro da equipe com permissão para este controle. Verifique a organização e o ambiente antes de alterar qualquer configuração. Revise o preço atual antes de efetuar um pagamento ou renovar a assinatura. As capturas de tela mostram um exemplo de espaço de trabalho ou a referência de integração pública; elas não mostram um cliente real nem um pagamento efetuado.
Configure e utilize a funcionalidade.
Etapa 1: Combine o produto, o host e as credenciais.
Escolha o modo Sandbox e grave o API A família que você está testando. A verificação de identidade usa o host /api/kyc e a chave de teste documentados. O Risk Intelligence usa seu host /api/v1 e chave secreta do Sandbox. O Identity Hub tem seu próprio contrato /api/identity. Não mova campos de solicitação entre famílias nem presuma que toda solicitação do Sandbox seja gratuita. Cenários explícitos do Risk Intelligence não são cobrados; solicitações comuns podem usar preços configurados.
Referência de integração: Sandbox
Etapa 2: Escolha um cenário de verificação compatível.
Abra o guia Sandbox e IDs de teste e selecione um ID que corresponda ao país e ao tipo de documento. Por exemplo, o ID nigeriano. BVN A configuração que termina em 01 é aprovada e 04 produz incompatibilidade de selfie. Resultados que envolvem apenas documentos precisam de um ID de documento. Use o cenário publicado ou a substituição compatível; números de identidade reais são recusados pelo contrato de verificação do Sandbox.
Referência de integração: Referência de cenário
Etapa 3: Utilize o Simulador para jornadas de risco assistidas
Abra Developers → Simulator in Sandbox. Selecione um cenário compatível e verifique sua elegibilidade. Cenários bloqueados ou que exigem configuração precisam atender aos pré-requisitos exibidos; não remova nenhum bloqueio para executá-los. Regras de viagem exigem uma política compatível publicada separadamente. Executar um cenário determinístico comprova seu manuseio controlado, não uma conexão real com um provedor ou uma troca de informações entre instituições.
Referência de integração: Configurar regra de viagem do Sandbox
Passo 4: Teste o receptor assinado de forma independente.
Crie o endpoint webhook do Sandbox e use o recurso de Teste para simular um evento compatível. Verifique a assinatura em relação aos bytes brutos e persista seu ID lógico. Teste o reenvio, uma assinatura inválida, uma assinatura expirada e uma falha do receptor. Os identificadores de exemplo gerados demonstram o formato; eles não são reutilizáveis. API recursos para uma chamada de recuperação posterior.
Referência de integração: Dispositivos orientados por catálogo
Etapa 5: Exercitar a incerteza e a ordenação
Simule uma resposta perdida após uma solicitação ter sido aceita e, em seguida, tente novamente a mesma operação com suas referências originais e chave de idempotência, quando o contrato permitir. Atrasar ou reordenar as notificações aceitas e reconciliar o estado atual. Testar um resultado pendente e indisponível separadamente de uma recusa. Inspecionar o Toden Registre e mantenha o estado da sua aplicação estável para duplicatas ou alterações de acesso incorretas.
Referência de integração: Asserção de ordenação
Etapa 6: Mantenha um registro concreto de prontidão para produção.
Registre os cenários testados, a decisão pretendida, a decisão observada, a ação de backend e as evidências de recuperação. Verifique o suporte. SDK versões, recuperação de permissões e dispositivos representativos. Configure o fluxo de trabalho de Produção separado, as chaves e o receptor somente após os requisitos de negócios e de capacidade serem atendidos. Remova os campos de cenário exclusivos do Sandbox. Uma pontuação verde em um teste local ou exemplo não é evidência de comportamento real do cliente.
Referência de integração: Lista de verificação para entrada em operação
Tire o máximo proveito dessa capacidade.
Mantenha os contratos no mesmo formato que os contratos públicos para que seu conjunto de testes detecte alterações de campo e versão.
Testar decisões finais tardias para fluxos de trabalho que dependem de triagem, pessoas-chave ou presença.
Em vez de pedir ao solicitante que corrija uma interrupção de serviço, forneça às falhas operacionais uma mensagem específica para o cliente e um plano de recuperação interno.
Faça o teste antes de confiar nele.
Execute os cenários de Sandbox ou simulador compatíveis com este produto. Quando uma ferramenta for exclusiva para Produção, verifique primeiro o acesso e o escopo e, em seguida, use apenas um teste de Produção permitido e cuidadosamente revisado. Uma captura de tela da documentação ou o carregamento bem-sucedido de uma página não constituem um teste de integração de ponta a ponta.
Todas as ramificações de decisão alcançam o caminho de aplicação pretendido.
Respostas perdidas e eventos repetidos não criam efeito duplicado.
Os termos "pendente" e "indisponível" permanecem distintos.
Os jogos continuam explicitamente identificados.
Alegações que se restringem à produção exigem comprovação presencial.
Solução de problemas
Meu documento de identidade real foi rejeitado no Sandbox.
Use um ID de teste publicado. A verificação em ambiente de teste não valida números de identidade reais.
Um cenário do simulador está bloqueado.
Cumpra os pré-requisitos da política exibida ou do calendário de jogos controlados.
Não foi possível recuperar um recurso de amostra.
Os exemplos do catálogo ilustram formas; seus IDs não são recursos armazenados em tempo real.
Abra as referências de configuração e integração.
Abra a ferramenta de painel de controle. (abre num novo separador)
Leia a referência de integração. (abre num novo separador)
Voltar para Soluções (abre num novo separador) . Escolha a funcionalidade que deseja ativar e siga o guia correspondente.
Fontes
Charles Archibong
Cofundador
Charles Archibong é cofundador da Toden. Ele escreve sobre verificação de identidade, tecnologia financeira e o trabalho prático de construção de serviços digitais confiáveis.
