Comment connecter vos dossiers clients à Toden
Charles Archibong, Cofondateur
Connectez les clients déjà présents dans votre application aux enregistrements Toden à l'aide de références stables. Conservez les informations dont vous disposez sur leur source de vérification plutôt que de convertir des déclarations importées en faits vérifiés.
Points clés
- Une référence externe renvoie à l'enregistrement souhaité.
- L'accusé de réception et la finalisation de l'importation sont deux choses distinctes.
- Les lignes ayant échoué restent explicables et peuvent être retentées.
- Les déclarations d'importation conservent une provenance véridique.
- Une récupération ciblée est rattachée au client existant.
Connectez les clients déjà présents dans votre application à Toden Utilisez des références fiables pour vos enregistrements. Conservez les informations relatives à leur source de vérification plutôt que de transformer des affirmations importées en faits vérifiés.
Avant de commencer
Références clients stables
Accès autorisé à l'importation ou à la gestion des profils
Utilisez un membre de l'équipe autorisé pour cette opération. Vérifiez l'organisation et l'environnement avant de modifier un paramètre. Consultez le prix actuel avant tout paiement ou renouvellement d'abonnement. Les captures d'écran présentent un exemple d'espace de travail ou la référence d'intégration publique ; elles ne représentent pas un client réel ni un paiement effectué.
Configurer et utiliser la fonctionnalité
Étape 1 : Choisir une référence client stable
Utilisez l'identifiant client ou professionnel permanent de votre système comme externalUserId . Conservez une seule référence pour chaque entité lors des importations, des vérifications et des activités. Déterminez si l'entité est une personne physique ou morale. N'utilisez pas une adresse e-mail susceptible de changer comme unique clé client. Obtenez l'autorisation de transférer les informations de profil que vous souhaitez enregistrer.
Référence d'intégration : Enregistrer ou mettre à jour une entité
Étape 2 : Choisir la provenance correcte
Utiliser UNVERIFIED pour un enregistrement dont la vérification n'est pas terminée. Utilisez EXTERNAL_VERIFIED uniquement lorsque votre propre autorisation KYC Le processus l'a vérifié, avec une source KYC véridique . Ne prétendez pas le contraire. MYAZA_VERIFIED L'importation d'un enregistrement externe ne sert qu'à débloquer une fonctionnalité. Les liens d'identité et les preuves de risque dépendent de leurs propres contrats ; un portefeuille déclaré ne constitue pas une preuve de propriété.
Référence d'intégration : KYC résolution de la provenance et de l'identité
Étape 3 : Enregistrez un enregistrement depuis votre serveur.
Appel POST Utilisez l'API `/api/identity/entities` avec une clé secrète, l'identifiant externe de l'utilisateur (`externalUserId`), le type et le profil autorisé du client. Ne fournissez que les informations connues. Réutiliser la même référence client met à jour l'entité existante au lieu d'en créer une nouvelle. Veillez à ce que le remplacement des métadonnées soit effectué de manière réfléchie et stockez l'identifiant de l'entité renvoyé dans l'enregistrement de votre application.
Référence d'intégration : Demande
Étape 4 : Relire l’enregistrement avant d’envoyer l’activité
Récupérer GET Utilisez l'API /api/identity/entities/{externalUserId} et comparez le sujet, la provenance et le profil autorisé renvoyés avec l'enregistrement souhaité. Examinez l'inscription au dépistage séparément. INACTIVE signifie que le dépistage n'est pas actif ; QUEUED Le contrôle n'est pas terminé. Conserver Toden Les identifiants d'entité et vos références externes sont distincts afin que les évaluations ultérieures utilisent le format de sujet attendu du point de terminaison.
Référence d'intégration : Rechercher une entité
Étape 5 : Importer un livre plus volumineux à l’aide de la tâche asynchrone
Pour un traitement par lots pris en charge, appelez POST Importez des entités (de 1 à 1 000 entrées) via l'API `/api/identity/entities/import` en utilisant le format d'enregistrement documenté. Stockez l'identifiant de tâche (jobId) renvoyé par la réponse 202. Surveillez la progression de la tâche jusqu'à sa finalisation, puis examinez le nombre d'opérations réussies, échouées et en attente, ainsi que les détails des échecs. Une importation confirmée ne garantit pas la réussite de chaque ligne.
Référence d'intégration : Importation en masse
Étape 6 : Corriger les défaillances et connecter la fonctionnalité suivante
Vérifiez la cohérence des références client erronées avec vos données sources avant de les réimporter. Ne réimportez pas les enregistrements validés avec des valeurs falsifiées. Une fois un enregistrement créé, effectuez une capture de lien à l'aide de la même référence ou envoyez l'activité du compte concerné. L'évaluation des risques et le suivi peuvent nécessiter l'identifiant d'entité renvoyé et une activation séparée. Conservez les erreurs au niveau client et les justificatifs d'intervention pour le support.
Référence d'intégration : Évaluer ou suivre un client existant
Tirez le meilleur parti de cette capacité
Conservez la même référence client même en cas de modification du nom de profil ou de l'adresse e-mail.
Utilisez une provenance vérifiée de manière externe et conservez la source afin que les examinateurs puissent comprendre l'origine.
Considérez les adresses de portefeuille comme des attributs de risque limités, et non comme des clés d'identité globales ou une autorisation de transfert.
Testez-le avant de vous y fier.
Exécutez les scénarios de test ou de simulation pris en charge pour ce produit. Si un outil est réservé à la production, vérifiez d'abord les droits d'accès et la portée, puis utilisez uniquement un test de production autorisé et préalablement validé. Une capture d'écran de la documentation ou le chargement réussi d'une page ne constituent pas un test d'intégration de bout en bout.
Une référence externe renvoie à l'enregistrement souhaité.
L'accusé de réception et la finalisation de l'importation sont deux choses distinctes.
Les lignes ayant échoué restent explicables et peuvent être retentées.
Les déclarations d'importation conservent une provenance véridique.
Une récupération ciblée est rattachée au client existant.
Dépannage
Un lot a renvoyé 202, mais des enregistrements sont manquants.
Analysez les progrès et les échecs d'un travail de longue haleine au lieu de supposer que la reconnaissance signifie son achèvement.
La modification du profil est refusée.
Vérifiez les champs autorisés par le contrat pour cet enregistrement vérifié. Ne remplacez pas les données d'identité vérifiées par un correctif général.
Une évaluation ne permet pas de trouver le client
Vérifiez l'organisation, l'environnement, le type de référence et l'ID d'entité attendus par ce point de terminaison.
Ouvrez les références d'installation et d'intégration
Ouvrir l'outil tableau de bord (s’ouvre dans un nouvel onglet)
Consultez le guide d'intégration (s’ouvre dans un nouvel onglet)
Retour à la page Solutions (s’ouvre dans un nouvel onglet) . Choisissez la fonctionnalité que vous souhaitez activer, puis suivez son guide.
Sources
Charles Archibong
Cofondateur
Charles Archibong est le cofondateur de Toden. Il écrit sur la vérification d'identité, les technologies financières et les aspects pratiques de la création de services numériques de confiance.
