Como confirmar os dados de contato com a Toden
Charles Archibong, Cofundador
Verifique o acesso ao contato com um código de e-mail ou telefone. Use a etapa de fluxo de trabalho para capturar jornadas ou a API independente quando seu aplicativo precisar de uma verificação de contato separada.
Pontos principais
- Códigos corretos, incorretos e expirados seguem caminhos diferentes.
- Um desafio verificado pode ser resolvido após a perda de resposta.
- Envios repetidos respeitam os limites de taxa.
- Um contato comprovado é registrado apenas em relação ao cliente pretendido.
Verifique o acesso do contato com um código de e-mail ou telefone. Use a etapa de fluxo de trabalho para capturar jornadas ou a etapa independente. API Quando seu aplicativo precisar de uma verificação de contato separada.
Antes de começar
Canal de entrega suportado
Acesso do cliente ao endereço de e-mail ou telefone
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: Escolha entre verificação por fluxo de trabalho ou verificação independente.
Para um processo de verificação, abra seu fluxo de trabalho e habilite a Verificação de E-mail , a Verificação de Telefone ou ambas. Use um fluxo de trabalho com escopo de contato quando precisar apenas atualizar os contatos de um cliente existente. Para uma tela de entrada de código independente em seu aplicativo, use o contato independente. API no seu backend. Não misture a comprovação com uma cobrança separada. SDK etapa de contato.
Exemplo de painel: Escolha entre fluxo de trabalho ou verificação independente.
Etapa 2: Configure a etapa de código do fluxo de trabalho
Selecione Verificação de e-mail → Configuração . Revise os campos Requisitos para prosseguir , Comprimento do código , Número máximo de tentativas e Estilo de entrada do código . Configure a etapa de verificação por telefone separadamente. Mantenha o limite de tentativas e a recuperação de expiração claros para os clientes. Revise as regras específicas do contato, como as descobertas sobre e-mails descartáveis, e salve e publique o fluxo de trabalho antes de criar novas sessões.
Exemplo de painel: Configure a etapa de código do fluxo de trabalho
Passo 3: Envie um código independente do seu backend
Chamar POST /api/kyc/contact/verifications com o canal definido como e-mail ou telefone e o destino . Inclua o país para formatos de telefone nacionais e seu externalUserId estável ao registrar a comprovação de um cliente existente. Armazene o ID do desafio retornado, o destino normalizado e a data de expiração. O ambiente de teste (sandbox) não envia uma mensagem real; seu canal de entrega é de teste.
Referência de integração: Enviar um código
Passo 4: Verifique o código em relação ao desafio.
Peça à pessoa para digitar o código e, em seguida, ligue. POST /api/kyc/contact/verifications/{id}/check com código . Use o ID do desafio retornado pela chamada de envio. Não marque o contato como verificado quando uma mensagem for enviada. Verifique o status: verificado . No ambiente de teste (Sandbox), o código é composto apenas por zeros no comprimento configurado. Nunca exponha uma chave secreta na tela de entrada de código.
Referência de integração: Verifique o código
Etapa 5: Lidar com vencimento, códigos incorretos e incertezas
Os códigos duram cinco minutos. Mostre as tentativas restantes para um código incorreto; um desafio esgotado ou expirado requer um novo envio. Após uma resposta de verificação perdida, recupere o código. GET Use o link /api/kyc/contact/verifications/{id} para reconciliar. Verificar novamente um desafio já verificado não gera nova cobrança. Evite envios repetidos para o mesmo destino; os limites por hora documentados são independentes das tentativas com código incorreto.
Referência de integração: Leia o desafio
Etapa 6: Armazene o contato comprovado e interprete os sinais.
Armazene o destino normalizado e o carimbo de data/hora verificado em seu aplicativo. Com uma entidade existente correspondente, o externalUserId permite que o serviço registre o endereço. OTP -Evidências verificadas; isso não cria uma entidade desaparecida. Use sinais descartáveis, virtuais e outros somente quando presentes. A posse de uma caixa postal ou telefone não constitui uma verificação completa de identidade. Verifique a taxa atual antes de usar a Produção.
Referência de integração: O que os sinais lhe dizem
Tire o máximo proveito dessa capacidade.
Mantenha o envio, o desafio e o cliente vinculados para que um código não possa verificar o contato de outro cliente.
Trate o tipo de linha desconhecido ou a evidência MX como desconhecida. Aplique as políticas com base nas descobertas registradas, não nos valores ausentes.
Utilize etapas de contato no fluxo de trabalho antes de verificações de captura dispendiosas, quando essa sequência se adequar à sua política de integração.
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.
Códigos corretos, incorretos e expirados seguem caminhos diferentes.
Um desafio verificado pode ser resolvido após a perda de resposta.
Envios repetidos respeitam os limites de taxa.
Um contato comprovado é registrado apenas em relação ao cliente pretendido.
Solução de problemas
Nenhuma mensagem do Sandbox chegou.
Isso é esperado. O Sandbox usa o canal de entrega de testes e um código totalmente zerado.
Um número de telefone nacional é inválido.
Forneça o código de país correto, com duas letras, ou utilize um código de área internacional.
O contato não consta no cadastro do cliente.
Verifique o externalUserId e se o cliente já existe na mesma organização e ambiente.
Abra as referências de configuração e integração.
Fluxos de trabalho abertos (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.
