Como verificar e monitorar a presença de um endereço com o Toden
Charles Archibong, Cofundador
Verifique a presença do endereço durante um período de observação compatível. Configure a captura, a geração de relatórios nativos e o consentimento do cliente em conjunto e, em seguida, distinga as evidências verificadas, falhas e inconclusivas.
Pontos principais
- Um monitor com progresso zero possui um caminho de diagnóstico claro.
- A recusa de permissão possui uma rota de recuperação ou de primeiro plano utilizável.
- Os termos "verificado", "falhou" e "inconclusivo" permanecem distintos.
- O relógio comprimido do Sandbox não é apresentado como prova de residência em tempo real.
- Os custos recorrentes e a opção de cancelamento são claramente indicados antes da ativação contínua.
Verifique a presença do endereço durante um período de observação compatível. Configure a captura, a geração de relatórios nativos e o consentimento do cliente em conjunto e, em seguida, distinga as evidências verificadas, falhas e inconclusivas.
Antes de começar
Endereço válido e consentimento do cliente.
Declarações de localização móvel suportadas
Opção de adesão separada para monitoramento contínuo.
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: Comece com um endereço válido já cadastrado.
Confirme se o cliente possui um PIN de endereço autorizado e uma referência externa estável. No fluxo de trabalho, habilite a Inteligência de Endereço e abra a Presença . Selecione o período de observação compatível e os requisitos de comprovação. Um PIN de uso único é uma solicitação; uma vigilância de vários dias requer um relatório separado. Não se presume que estabelecimentos comerciais e trajetos somente via navegador, que não são compatíveis, forneçam comprovação de presença residencial.
Referência de integração: Verificação de presença
Etapa 2: Configure o aplicativo nativo e o processo de consentimento.
Use React Native ou Flutter SDK e passe o userId estável. Siga a configuração de localização em segundo plano para sua plataforma ao ativar o relatório em segundo plano. O React Native precisa do registro documentado na inicialização; o Flutter precisa das declarações do manifesto e do Info.plist. Explique o que é coletado e permita que a pessoa controle as permissões. Habilitar a troca de fluxo de trabalho sem configurar o aplicativo deixa o monitoramento sem evidências.
Referência de integração: O que seu aplicativo precisa fazer
Etapa 3: Relatar presença na abertura do aplicativo e no retorno ao primeiro plano
Sempre que o aplicativo for aberto ou retornar ao primeiro plano, o sistema de relatórios de presença documentado será acionado para o mesmo externalUserId. Isso é útil para usuários que negam permissão para execução em segundo plano e para telefones com gerenciadores de bateria que restringem essa permissão. Não fabrique coordenadas nem substitua um endereço IP. Se a captura ocorreu em um fluxo hospedado, utilize a transferência de PIN autorizada documentada antes de esperar relatórios nativos.
Referência de integração: Relatório de presença a partir do seu aplicativo
Passo 4: Verifique o progresso real do relógio
Open Risk Intelligence → Verificação de endereço ou recuperação GET /api/kyc/address/presence/{externalUserId} . Inspecione o status, o progresso, a contagem de observações e o nível de evidência. O endpoint não retorna o PIN. Uma observação travada em zero precisa de um relatório de recuperação. Use o motivo do relatório e o SDK O status de presença (presenceStatus) permite distinguir entre PIN ausente, permissão negada e serviços de localização desativados.
Referência de integração: Mostrar à pessoa onde está o cheque
Etapa 5: Interprete os três caminhos de resolução
Verificado significa que as evidências registradas atenderam à política. Reprovado requer uma contradição de integridade, como evidências de localização falsificada; a ausência não é uma reprovação. Inconclusivo significa que o período terminou sem evidências suficientes e não constitui uma constatação contra o cliente. Use eventos de resultado assinados para atualizar seu aplicativo. Um requisito somente de análise em segundo plano deve inspecionar as evidências de política apropriadas, em vez de se basear apenas no total de dias.
Referência de integração: Manter a decisão sobre isso
Etapa 6: Habilite os ciclos contínuos somente quando necessário.
Para confirmação contínua de endereço, revise a configuração separada de ativação permanente, a frequência e o preço anual. As opções de frequência suportadas são 30, 60, 90, 180 ou 365 dias. Mantenha uma verificação de presença única separada da cobertura de renovação anual. Desativar a renovação interrompe os ciclos futuros; uma verificação já em andamento ainda tem sua própria resolução. Revise as permissões e a recuperação de revogação em seu aplicativo.
Referência de integração: Monitoramento contínuo
Tire o máximo proveito dessa capacidade.
Utilize a geração de relatórios em primeiro plano como uma alternativa suportada e mostre a camada de evidências que está sendo executada.
Teste as restrições de bateria do fabricante nos dispositivos Android que seus clientes usam; use a opção de serviço em primeiro plano documentada somente com configuração explícita e divulgação visível ao cliente.
Mostre o progresso sem revelar o endereço ou a localização da pessoa. Notifique-a pelo aplicativo quando o resultado registrado mudar.
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.
Um monitor com progresso zero possui um caminho de diagnóstico claro.
A recusa de permissão possui uma rota de recuperação ou de primeiro plano utilizável.
Os termos "verificado", "falhou" e "inconclusivo" permanecem distintos.
O relógio comprimido do Sandbox não é apresentado como prova de residência em tempo real.
Os custos recorrentes e a opção de cancelamento são claramente indicados antes da ativação contínua.
Solução de problemas
Os dias permanecem em zero.
Verifique as chamadas do repórter, o PIN armazenado, a referência do usuário, os serviços e as permissões.
Relatórios em segundo plano foram desativados.
Leia o texto completo. SDK status e use o caminho de recuperação de configurações suportado. Não continue rotulando como segundo plano.
A janela não foi conclusiva.
Recolha as provas documentais em falta ou ofereça a próxima viagem adequada. A ausência não comprova um endereço falso.
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.
