Comment ajouter une vérification à votre application avec Toden
Charles Archibong, Cofondateur
Intégrez la vérification à votre application à l'aide d'un flux de travail publié et d'un SDK compatible ou d'une session hébergée. Conservez la capture des données tout au long du parcours client et le traitement des résultats finaux côté serveur.
Points clés
- L'application ouvre le flux de travail publié prévu.
- Les identifiants secrets restent stockés en arrière-plan.
- Les voyages annulés, expirés et abandonnés sont pris en charge.
- Les résultats finaux correspondent aux attentes du client visé.
- La production utilise son propre flux de travail, ses propres clés et son propre récepteur.
Ajoutez une vérification à votre application à l'aide d'un flux de travail publié et d'une méthode prise en charge. SDK ou session hébergée. Conservez la capture des données tout au long du parcours client et gérez le résultat final dans votre système.
Avant de commencer
Un flux de travail publié
Le soutien SDK ou chemin de session hébergé
Votre serveur récupère le résultat final
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 : Publier le flux de travail que les clients doivent utiliser
Ouvrez Configuration → Flux de travail dans l'environnement de test. Créez ou ouvrez le flux de travail approprié (individuel, métier ou périmètre). Configurez uniquement les contrôles de capture et de révision nécessaires. Enregistrez et publiez le flux de travail, puis copiez son ID. Vérifiez l'organisation et l'environnement avant l'intégration. Un flux de travail non publié ne constitue pas une configuration de capture en direct réutilisable.
Exemple de tableau de bord : Publier le flux de travail que les clients doivent utiliser
Étape 2 : Choisissez la capture intégrée ou une session hébergée
Utilisez le Web SDK Pour la capture via navigateur, React Native ou Flutter pour la capture mobile native, et une session hébergée lorsqu'un lien est nécessaire pour un candidat connu. Fonctionnalités natives uniquement, telles que : NFC Un chemin d'accès spécifique est requis. Un lien de flux de travail partagé est accessible à plusieurs candidats ; une session créée par le serveur est réservée à un seul candidat. Choisissez le chemin d'accès adapté à votre produit plutôt que de mélanger leurs identifiants.
Référence d'intégration : Trois façons d'exécuter un flux de travail
Étape 3 : Installez la version actuellement prise en charge SDK et configurer la capture
Suivez les instructions de votre plateforme SDK Consultez le guide relatif au package pris en charge, aux dépendances homologues requises et aux déclarations d'autorisation. Transmettez l'identifiant du flux de travail (workflowId) , la clé API publiable correspondante et votre identifiant utilisateur stable (userId ). Le flux de travail fournit les étapes configurées ; les données d'exécution restent au niveau de votre application. Avant de résoudre un problème de flux ignorant l'identifiant du flux de travail, vérifiez la version minimale requise documentée pour l'activation des flux de travail.
Référence d'intégration : Flux de travail
Étape 4 : Pour la capture hébergée, créez la session sur votre serveur.
Appel POST Utilisez l'API KYC pour les sessions avec une clé secrète, l'ID du workflow publié et l'ID externe prévu. Ajoutez les préremplissages autorisés et les métadonnées uniquement lorsque cela est nécessaire. Stockez la référence de session et fournissez l'identifiant privé. URL à l'intention du demandeur. L'instantané du flux de travail est figé à la date de création. Ne placez pas de clé secrète dans une WebView, une version mobile ou un module navigateur.
Référence d'intégration : Demande
Étape 5 : Enregistrez votre demande, puis attendez le résultat.
Le SDK Le rappel de soumission identifie une soumission ; il ne s'agit pas du rappel d'approbation finale. Stockez sa référence de vérification sur votre serveur. Consultez l'état actuel avec l'autorisation requise. API ou recevoir des webhooks signés. Distinguez clairement le traitement, la vérification humaine, l'attente d'une nouvelle soumission, les erreurs et les résultats finaux. Consultez le statut final avec checkStatus et son explication, notamment lorsque la décision dépend d'autres vérifications.
Référence d'intégration : États
Étape 6 : Tester l’intégralité du parcours et préparer la production séparément
Utilisez les identifiants et les configurations Sandbox compatibles pour les tests de capture, d'état et de réception. Testez les refus d'autorisation, les abandons, les nouvelles tentatives, les revues et les rejets. En production, obtenez l'approbation métier, publiez le flux de travail de production, configurez les clés et le récepteur de résultats adaptés à l'environnement, et consultez la tarification en vigueur. Un passage en Sandbox valide votre procédure ; il ne garantit pas le bon fonctionnement de chaque contrôle ou appareil en production.
Référence d'intégration : Liste de contrôle pour la mise en production
Tirez le meilleur parti de cette capacité
Permettre à la publication du flux de travail de modifier la configuration de capture sans dupliquer cette configuration dans chaque version de l'application.
Utilisez les métadonnées pour les corrélations autorisées, telles qu'une référence d'application, en restant dans les limites documentées.
Testez le transfert d'appel, la récupération des autorisations et les événements hébergés par le navigateur pour le trajet que vous effectuez réellement.
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.
L'application ouvre le flux de travail publié prévu.
Les identifiants secrets restent stockés en arrière-plan.
Les voyages annulés, expirés et abandonnés sont pris en charge.
Les résultats finaux correspondent aux attentes du client visé.
La production utilise son propre flux de travail, ses propres clés et son propre récepteur.
Dépannage
Le SDK ignore workflowId
Vérifiez la version du package installé par rapport à la configuration minimale documentée et vérifiez le flux de travail publié.
Le flux de travail est introuvable.
Associer la clé, l'organisation, l'environnement et l'identifiant publié.
Mon application a été intégrée immédiatement après onSubmit
Attendez la version finale officielle au lieu de considérer la soumission de la capture comme une approbation.
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.
