Como conectar seus registros de clientes com o Toden
Charles Archibong, Cofundador
Conecte os clientes já cadastrados em seu aplicativo aos registros da Toden usando referências estáveis. Mantenha as informações que você possui sobre a fonte de verificação deles, em vez de transformar declarações importadas em fatos verificados.
Pontos principais
- Uma referência externa resolve-se no registro pretendido.
- O reconhecimento e a conclusão da importação são processos distintos.
- As linhas com falha permanecem explicáveis e passíveis de nova tentativa.
- Os produtos importados preservam sua procedência verídica.
- Uma recaptura de escopo é vinculada ao cliente existente.
Conecte os clientes que já estão no seu aplicativo ao Toden Use registros com referências estáveis. Mantenha as informações que você possui sobre a fonte de verificação, em vez de transformar alegações importadas em fatos verificados.
Antes de começar
Referências de clientes estáveis
Acesso autorizado para importação ou gerenciamento de perfil
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: Escolha uma referência de cliente estável.
Utilize o ID permanente do cliente ou da empresa do seu próprio sistema como externalUserId . Mantenha uma única referência para o mesmo sujeito em todas as importações, verificações e atividades. Defina se o sujeito é uma pessoa física ou jurídica. Não utilize um endereço de e-mail que possa ser alterado como a única chave do cliente. Obtenha autorização para transferir os dados do perfil que você pretende cadastrar.
Referência de integração: Registrar ou atualizar uma entidade
Passo 2: Escolha a proveniência correta
Usar UNVERIFIED Para registros que ainda não foram verificados. Use EXTERNAL_VERIFIED somente quando autorizado por você KYC O processo foi verificado com uma fonte KYC confiável . Não afirme. MYAZA_VERIFIED Para que um registro externo importado sirva apenas para desbloquear uma funcionalidade. Os vínculos de identidade e as evidências de risco dependem de seus próprios contratos; uma carteira reivindicada não comprova a propriedade de um item.
Referência de integração: KYC resolução de proveniência e identidade
Passo 3: Registre um registro a partir do seu painel administrativo.
Chamar POST /api/identity/entities com uma chave secreta e o externalUserId, tipo e perfil permitido do cliente. Forneça apenas detalhes conhecidos. Reutilizar a mesma referência de cliente atualiza a entidade existente em vez de criar outra. Mantenha a semântica de substituição de metadados deliberada e armazene o entityId retornado com o registro do seu aplicativo.
Referência de integração: Solicitação
Passo 4: Leia o registro novamente antes de enviar a atividade.
Recuperar GET Acesse /api/identity/entities/{externalUserId} e compare o sujeito, a proveniência e o perfil permitido retornados com o registro pretendido. Analise o cadastro de triagem separadamente. INACTIVE significa que o rastreio não está ativo; QUEUED Não é um cheque totalmente limpo. Mantenha Toden Os IDs das entidades e suas referências externas devem ser distintos para que avaliações posteriores utilizem o formato de assunto esperado do endpoint.
Referência de integração: Pesquisar uma entidade
Etapa 5: Importe um livro maior usando a tarefa assíncrona.
Para um lote compatível, ligue para POST Importe de 1 a 1.000 entradas usando o formato de registro documentado em /api/identity/entities/import . Armazene o jobId retornado na resposta 202. Monitore o progresso da tarefa até que ela se estabilize e, em seguida, inspecione as contagens de tarefas concluídas com sucesso, falhas e pendentes, bem como os detalhes das falhas. Uma importação confirmada não garante que todas as linhas foram importadas com sucesso.
Referência de integração: Importação em massa
Etapa 6: Corrija as falhas e conecte a próxima funcionalidade.
Antes de tentar novamente, compare as referências de clientes com falha com seus dados de origem. Não reimporte registros bem-sucedidos com valores falsificados. Assim que um registro existir, vincule a captura usando a mesma referência ou envie a atividade da conta compatível. Avaliações e monitoramento de risco explícitos podem exigir o ID da entidade retornado e ativação separada. Mantenha os erros e as evidências de trabalho em nível de cliente para suporte.
Referência de integração: Avaliar ou monitorar um cliente existente
Tire o máximo proveito dessa capacidade.
Mantenha a referência do cliente estável quando o nome do perfil ou o e-mail forem alterados.
Utilize informações de procedência verificadas externamente e mantenha a fonte para que os revisores possam compreender a origem.
Considere os endereços de carteira como atributos de risco específicos, e não como chaves de identidade globais ou permissões de transferência.
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.
Uma referência externa resolve-se no registro pretendido.
O reconhecimento e a conclusão da importação são processos distintos.
As linhas com falha permanecem explicáveis e passíveis de nova tentativa.
Os produtos importados preservam sua procedência verídica.
Uma recaptura de escopo é vinculada ao cliente existente.
Solução de problemas
Um lote retornou 202, mas faltam registros.
Leia sobre o progresso e as falhas do trabalho duradouro em vez de presumir que o reconhecimento significa conclusão.
A edição do perfil foi recusada.
Verifique quais campos o contrato permite para esse registro verificado. Não sobrescreva informações de identidade verificadas por meio de uma atualização genérica.
Uma avaliação não consegue encontrar o cliente.
Verifique a organização, o ambiente, o tipo de referência e o ID da entidade esperados por esse endpoint.
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.
