Como verificar novamente um cliente com a Toden
Charles Archibong, Cofundador
Solicite a um candidato já cadastrado que refaça uma verificação concluída, seja integralmente ou apenas em etapas selecionadas. A nova verificação mantém o ID da verificação e registra uma nova tentativa, permitindo que sua equipe explique o que mudou.
Pontos principais
- A repetição de uma etapa selecionada preserva o ID de verificação.
- O candidato visualiza a mensagem de correção.
- As tentativas antigas permanecem disponíveis e os links antigos não podem competir.
- Uma notificação de tentativa antiga enviada tardiamente não sobrescreve o novo resultado.
Solicite a um candidato já cadastrado que refaça uma verificação concluída, seja integralmente ou apenas em etapas selecionadas. A nova verificação mantém o ID da verificação e registra uma nova tentativa, permitindo que sua equipe explique o que mudou.
Antes de começar
Referência de cliente existente
Permissão para solicitar ou revisar uma verificaçã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.
Passo 1: Encontre a verificação concluída.
Abra o cliente em Clientes → Pessoas Físicas ou Jurídicas e, em seguida, abra a verificação relevante. Verifique o sujeito, o ambiente e o ID antes de agir. Use Verificar novamente para concluir uma verificação baseada em fluxo de trabalho. Uma verificação incompleta ainda pode retornar um resultado; portanto, não inicie uma nova verificação enquanto ela estiver em processamento. Uma verificação sem um fluxo de trabalho disponível requer o caminho de reinício documentado.
Referência de integração: Verifique novamente
Etapa 2: Selecione as partes que precisam de outra captura.
Selecione as etapas que o candidato deve refazer. Por exemplo, a etapa de verificação de presença exige uma nova selfie; a etapa de captura de documentos exige fotos dos documentos. Deixar etapas em branco exige a repetição de todo o processo. Escreva uma breve mensagem para o candidato explicando a correção, como, por exemplo, tirar uma nova selfie em um ambiente com melhor iluminação. Mantenha as evidências já válidas, a menos que sua política realmente exija uma atualização completa.
Referência de integração: Refaça apenas o que falhou
Etapa 3: Escolha a versão do fluxo de trabalho deliberadamente.
Escolha a política original para executar o snapshot original do fluxo de trabalho ou a mais recente para usar a versão publicada atualmente. Se você omitir esta opção, a configuração de reexecução do próprio fluxo de trabalho será aplicada. Verifique se uma política atual alterada afeta o que o solicitante deve fornecer. Não presuma que os fluxos de trabalho original e mais recente solicitem as mesmas evidências.
Referência de integração: Corpo da solicitação
Etapa 4: Crie e entregue o novo link
A partir do seu backend, faça a chamada. POST Execute o comando /api/kyc/verifications/{id}/rerun usando uma chave secreta e as etapas, mensagem e política selecionadas. Adicione o e-mail somente se desejar. Toden Para enviar o link, mantenha o session.url privado, restrito ao destinatário; trata-se de uma credencial. Verifique o resultado da entrega. Um e-mail com falha não invalida o link retornado, portanto, seu próprio canal de entrega autorizado ainda poderá utilizá-lo.
Referência de integração: Resposta 201 Criada
Etapa 5: Mantenha o candidato na última tentativa.
A verificação passa para o status "aguardando reenvio" . Links anteriores para a mesma verificação param de funcionar. Mostre ao solicitante o novo link em vez de enviar vários links conflitantes. Se outro revisor decidir sobre a verificação ou iniciar uma nova verificação posteriormente, reconcilie o estado atual. Um link substituído não é motivo para criar um novo registro de cliente.
Referência de integração: Quando o candidato reenviar a inscrição
Etapa 6: Atualize o registro existente quando eles terminarem.
A próxima submissão torna-se outra tentativa com o mesmo ID de verificação. Gerencie o status final mais recente e a tentativa incremental, mantendo os resultados anteriores. O trabalho faturável refere-se às etapas refeitas, não às evidências mantidas da tentativa anterior. Registre o motivo da atualização e use o resultado atual para atualizar sua solicitação, em vez de deixar que uma notificação tardia da tentativa anterior a sobrescreva.
Referência de integração: Quando o candidato reenviar a inscrição
Tire o máximo proveito dessa capacidade.
Use refazer tarefas específicas para problemas de captura que podem ser corrigidos e refazer tarefas completamente para uma atualização genuína de toda a política.
Preservar as tentativas anteriores e a justificativa do revisor para fins de suporte e auditoria.
Teste as seleções de política originais e as mais recentes após alterar um fluxo de trabalho, incluindo links que já foram enviados.
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.
A repetição de uma etapa selecionada preserva o ID de verificação.
O candidato visualiza a mensagem de correção.
As tentativas antigas permanecem disponíveis e os links antigos não podem competir.
Uma notificação de tentativa antiga enviada tardiamente não sobrescreve o novo resultado.
Solução de problemas
O API diz verificação_em_progresso
Aguarde a conclusão das verificações em andamento e a recuperação do status atual antes de prosseguir com outra ação.
O link antigo do solicitante parou de funcionar.
Use o link válido mais recente. Reprises e decisões posteriores substituem links anteriores.
Não há fluxo de trabalho disponível.
Verifique se o fluxo original existe e está publicado; uma verificação que não seja de fluxo de trabalho não pode ser executada novamente por meio deste contrato.
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.
