Authentification renforcée
Ce que ce cas d'usage résout
Détecter si une biométrie faciale est déjà associée à un autre compte actif dans votre base opérateur — le principe « Un visage, un contrat ». Avec un seul appel API, croisez le visage capturé avec votre base d'enregistrement et bloquez les comptes dupliqués au moment de l'action.
Utilisez ce cas d'usage lorsque :
- L'utilisateur tente d'exécuter une action (demande de premier retrait, cash-out) et vous souhaitez vérifier si cette biométrie appartient déjà à un autre compte actif dans votre système.
- Vous devez effectuer une ingestion rétroactive d'une base historique de selfies pour identifier les doublons existants (mode batch). Il s'agit du flux d'importation de base biométrique.
- Votre modèle commercial exige que chaque individu dispose d'au plus un compte actif par opérateur (ou par pays).
- Vous souhaitez réduire la charge sur le bureau de révision vidéo manuelle, en remplaçant l'analyse humaine par une décision automatique et déterministe.
N'utilisez pas ce cas d'usage lorsque :
- Vous devez valider l'authenticité d'un document d'identité → consultez les cas d'usage d'onboarding.
- Vous devez confirmer que la personne effectuant la transaction est bien le titulaire du compte (vérification 1:1) → consultez les cas d'usage d'authentification continue.
- Votre produit autorise plusieurs comptes par personne par conception (par exemple, comptes personnels et professionnels) → évaluez la configuration
clientReferenceSegmentavec l'équipe Unico avant d'activer cette règle. Ce champ définit le périmètre de recherche : la comparaison 1:N ne porte que sur les enregistrements rattachés au même segment, de sorte que des segments distincts peuvent coexister chez un seul opérateur sans générer de faux positifs.
Capacités impliquées
Pipeline exécuté au sein d'un seul processus :
| Capacité | Obligatoire | Rôle dans le flux |
|---|---|---|
| Liveness | Optionnel pour l'API ; obligatoire pour Web et Native | Vérification de liveness au moment de la capture. |
| Multi-comptes 1:N | Obligatoire | Effectue une recherche biométrique segmentée dans la base de l'opérateur, en croisant le visage reçu avec tous les enregistrements du même segment. |
Prérequis
- Bearer token — voir Authentification.
- Identifiants Sandbox — voir Environnements.
- SDK ou composant Web installé — uniquement pour les intégrations Web et SDK. Voir SDKs et outils.
- Champ
clientReferencerenseigné dans toutes les requêtes — identifie de manière unique l'utilisateur dans le système de l'opérateur. Doit être unique dans la base de données du client, comporter un maximum de 256 caractères et ne contenir aucun espace. Ce champ est l'identifiant principal pour Multi-comptes 1:N.
Mise en œuvre étape par étape
- Native
- Web
- API
Intégration via SDK natif — la capture s'exécute dans votre application en utilisant le SDK Unico pour Android, iOS ou Flutter.
- Installer le SDK — ajoutez la dépendance du SDK Unico pour votre plateforme. Consultez le guide de configuration pour Android, iOS ou Flutter.
- Créer un processus — appelez Create Process avec la valeur
flowappropriée et l'identifiant de l'utilisateur. Utilisez letokenretourné pour initialiser le SDK. - Démarrer la capture — le SDK affiche l'interface caméra et effectue la détection de vivacité sur l'appareil, retournant le payload capturé.
- Consulter le résultat — appelez Get Process pour récupérer les résultats des capacités.
- Appliquer les règles métier — évaluez les champs de la réponse pour approuver, refuser ou escalader.
Intégration via iFrame, Redirection ou Natif — Unico héberge l'interface de capture et vous recevez le résultat via polling.
- Créer un processus — appelez Create Process avec la valeur
flowappropriée et l'identifiant de l'utilisateur. La réponse inclut unuserRedirectUrl. - Rediriger l'utilisateur — envoyez l'utilisateur vers
userRedirectUrl. Unico affiche le parcours de capture. Ou utilisezwebAppTokendans les applications natives. - L'utilisateur complète le parcours — après la capture, l'utilisateur est redirigé vers votre
callbackUri. - Consulter le résultat — appelez Get Process pour récupérer les résultats des capacités.
- Appliquer les règles métier — évaluez les champs de la réponse pour approuver, refuser ou escalader.
Intégration directe via l'API — capturez le selfie en utilisant le SDK Unico ou votre propre interface en suivant le Standard de capture, puis envoyez l'image directement à l'API Unico.
- Capturer le selfie — utilisez le SDK Unico pour votre plateforme, ou créez votre propre interface en suivant le Standard de capture, pour obtenir une image de selfie répondant aux exigences de liveness.
- Créer un processus — appelez Créer un processus avec l'identifiant de l'utilisateur et le selfie en
imagebase64. - Interroger le résultat — appelez Obtenir un processus pour récupérer les résultats des capacités.
- Appliquer les règles métier — évaluez les champs de la réponse pour approuver, refuser ou escalader.


