Comment confirmer les coordonnées de Toden
Charles Archibong, Cofondateur
Vérifiez l'accès des contacts par e-mail ou code téléphonique. Utilisez l'étape de flux de travail pour les parcours de capture, ou l'API autonome lorsque votre application nécessite une vérification de contact distincte.
Points clés
- Les codes corrects, incorrects et expirés empruntent des chemins différents.
- Un défi vérifié peut être résolu après une perte de réponse.
- Les envois répétés respectent les limites de débit.
- Un contact avéré n'est enregistré que pour son client prévu.
Vérifiez l'accès du contact par e-mail ou code téléphonique. Utilisez l'étape du flux de travail pour les parcours de capture, ou l'étape autonome. API lorsque votre application nécessite une vérification de contact séparée.
Avant de commencer
Canal de distribution pris en charge
L'accès du client à l'adresse e-mail ou au téléphone
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 : Choisissez entre la vérification en flux de travail et la vérification autonome
Pour un parcours de vérification, ouvrez votre flux de travail et activez la vérification par e-mail , la vérification par téléphone ou les deux. Utilisez un flux de travail limité au contact lorsque vous devez uniquement mettre à jour les contacts d'un client existant. Pour un écran de saisie de code indépendant dans votre application, utilisez le contact autonome. API sur votre système d'administration. Ne mélangez pas sa preuve avec une facturation séparée. SDK étape de contact.
Exemple de tableau de bord : Choisissez entre la vérification par flux de travail ou la vérification autonome
Étape 2 : Configurer l’étape de code du flux de travail
Sélectionnez Vérification d'e-mail → Configuration . Vérifiez les champs « Informations requises pour continuer » , « Longueur du code » , « Nombre maximal de tentatives » et « Style de saisie du code » . Configurez séparément l'étape d'activation du téléphone. Expliquez clairement aux clients la limite de tentatives et la possibilité de récupérer le code expiré. Examinez les règles spécifiques aux contacts, telles que les alertes concernant les e-mails jetables, puis enregistrez et publiez le flux de travail avant de créer de nouvelles sessions.
Exemple de tableau de bord : Configurer l’étape de code du flux de travail
Étape 3 : Envoyez un code autonome depuis votre serveur.
Appel POST Utilisez l' API KYC (/api/kyc/contact/verifications) avec le canal défini sur « e-mail » ou « téléphone » et la destination . Indiquez le pays pour les formats de téléphone nationaux et votre identifiant utilisateur externe stable lors de l'enregistrement d'une preuve pour un client existant. Stockez l'identifiant de défi renvoyé, la destination normalisée et la date d'expiration. L'environnement de test (Sandbox) n'envoie pas de message réel ; son canal de transmission est dédié aux tests.
Référence d'intégration : Envoyer un code
Étape 4 : Vérifier que le code correspond à son défi
Demandez à la personne de saisir le code, puis appelez. POST Utilisez la commande `/api/kyc/contact/verifications/{id}/check` avec le code . Utilisez l'ID de défi renvoyé par l'appel `send`. Ne marquez pas le contact comme vérifié lors de l'envoi d'un message. Vérifiez le statut : `verified` . En mode Sandbox, le code est composé uniquement de zéros à la longueur configurée. Ne divulguez jamais de clé secrète sur l'écran de saisie du code.
Référence d'intégration : Consultez le code
Étape 5 : Gérer l’expiration, les codes erronés et l’incertitude
Les codes sont valides pendant cinq minutes. Afficher le nombre de tentatives restantes pour un code erroné ; un code épuisé ou expiré nécessite un nouvel envoi. Après une réponse de vérification perdue, récupérer GET Utilisez l'API KYC/contact/verifications/{id} pour la validation. La revérification d'un défi validé est gratuite. Évitez les envois répétés vers la même destination ; les limites horaires indiquées sont indépendantes des tentatives avec code incorrect.
Référence d'intégration : Lire un défi
Étape 6 : Stocker le contact établi et interpréter les signaux
Stockez la destination normalisée et l'horodatage vérifié dans votre application. Avec une entité existante correspondante, externalUserId permet à l'enregistrement du service OTP Des preuves vérifiées sont disponibles ; cela ne crée pas d’entité manquante. N’utilisez les signaux jetables, virtuels et autres que lorsqu’ils sont présents. La possession d’une boîte aux lettres ou d’un téléphone ne constitue pas une vérification d’identité complète. Consultez le tarif en vigueur avant d’utiliser la production.
Référence d'intégration : Que vous disent les signaux ?
Tirez le meilleur parti de cette capacité
Liez systématiquement l'envoi, le défi et le client afin qu'un code ne puisse pas vérifier les coordonnées d'un autre client.
Considérez le type de ligne ou les données MX inconnus comme inconnus. Appliquez les politiques de sécurité incendie en fonction des résultats enregistrés, et non des valeurs manquantes.
Utilisez les étapes de contact du flux de travail avant les vérifications de capture coûteuses lorsque cette séquence correspond à votre politique d'intégration.
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.
Les codes corrects, incorrects et expirés empruntent des chemins différents.
Un défi vérifié peut être résolu après une perte de réponse.
Les envois répétés respectent les limites de débit.
Un contact avéré n'est enregistré que pour son client prévu.
Dépannage
Aucun message Sandbox n'a été reçu
C'est normal. Sandbox utilise le canal de distribution des tests et un code entièrement vide.
Un numéro de téléphone national est invalide
Indiquez le pays à deux lettres ou utilisez un format d'indicatif téléphonique international.
Le contact ne figure pas dans le dossier client.
Vérifiez l'externalUserId et assurez-vous que le client existe déjà dans la même organisation et le même environnement.
Ouvrez les références d'installation et d'intégration
Flux de travail ouverts (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.
