Aller au contenu principal

Vérification silencieuse

La Vérification silencieuse permet à une identité récurrente, déjà validée, de terminer une transaction Vérification sans carte présente sans écran de capture visible. Au lieu de demander à l'utilisateur un nouveau selfie, la technologie d'Unico évalue des signaux et la récurrence en arrière-plan pour décider si la transaction peut être approuvée silencieusement.

La Vérification silencieuse n'est pas un produit distinct — c'est une étape supplémentaire par-dessus le même flux de création de transaction décrit dans Transactions de paiement et Onboarding de carte de crédit. Collecter des signaux de contexte avec le SDK et envoyer cette même clé externe lors de la création de la transaction est ce qui permet une approbation silencieuse.

Quand cela s'applique
  • La Vérification silencieuse s'applique lorsqu'il y a suffisamment d'historique pour que la technologie d'Unico évalue l'identité à partir de signaux.
  • Lorsque cette évaluation n'est pas possible — par manque d'historique ou pour d'autres raisons — la transaction revient au flux visuel standard. Cela peut se produire, par exemple, la première fois qu'une identité donnée est vue sur le réseau.
1. Collecter les métadonnées de l'appareil avec le SDK

Installez et initialisez le SDK de capture pour votre plateforme comme d'habitude — la Vérification silencieuse ne modifie pas cette configuration. Suivez le guide de collecte de données de monitoring de la plateforme pour envoyer externalUserId :

info

Flutter n'est pas encore pris en charge pour la Vérification silencieuse.

Il ne s'agit pas seulement de métadonnées d'observabilité ici

Les guides de collecte de données de monitoring décrivent externalUserId comme une télémétrie optionnelle qui « ne modifie pas le comportement de capture du SDK ni la réponse de l'API ». Cela est vrai pour le SDK seul. Dans Vérification sans carte présente, ce même champ est ce que le backend utilise pour décider si la transaction peut être approuvée silencieusement. L'envoyer est ce qui active la Vérification silencieuse pour cette transaction — ici, ce champ n'est pas inerte.

Deux ajustements à la configuration de capture standard sont nécessaires pour que le flux reste silencieux :

  • Mobile (Android / iOS) : utilisez la surcharge prepareCamera / prepareSelfieCamera qui reçoit un objet PrepareInfo avec externalUserId, et n'appelez pas la méthode d'ouverture de la caméra à l'intérieur du callback de succès — sauf si vous souhaitez réellement le flux visuel complet pour cette session.
unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
        // Pas besoin d'appeler cameraOpener?.open() ici — la collecte en arrière-plan a déjà commencé.
    }
    override fun onCameraFailed(message: String?) { /* handle error */ }
}, PrepareInfo("YOUR_EXTERNAL_USER_ID"))
  • Web : appelez setSilentInfo(externalUserId, useCase) sur l'instance UnicoCheckBuilder avant d'appeler prepareCamera / prepareSelfieCamera, et de même, n'ouvrez pas la caméra dans le callback de succès.
unicoCamera.setSilentInfo("YOUR_EXTERNAL_USER_ID");
await unicoCamera.prepareSelfieCamera(config, SelfieCameraTypes.SMART);
// Pas besoin d'ouvrir la caméra ici — la collecte en arrière-plan a déjà commencé.
Fenêtre de timing

Le SDK collecte les données en arrière-plan, il doit donc y avoir un écart minimum avant de créer la transaction :

  • Démarrez la préparation du SDK au moins 4 secondes avant d'appeler l'API de transaction — trop tôt, et la collecte pourrait ne pas être terminée.
  • Les données collectées sont valides pendant jusqu'à 5 minutes — trop tard, et elles auront expiré au moment de la création de la transaction.
2. Créer la transaction avec le même externalUserID

externalUserID est optionnel — mais sans lui, la Vérification silencieuse ne peut pas avoir lieu pour cette transaction. Lors de la création de la transaction — via Transactions de paiement ou Onboarding de carte de crédit — envoyez exactement le même externalUserID utilisé dans le SDK, à l'intérieur de additionalInfo :

{
  "additionalInfo": {
    "externalUserID": "YOUR_EXTERNAL_USER_ID"
  }
}

L'omettre ne provoque aucune erreur — la transaction est tout de même créée normalement, elle suit simplement toujours le flux standard avec friction visuelle.

3. Gérer la réponse

Si la transaction est éligible et approuvée silencieusement, aucune action supplémentaire n'est nécessaire :

{
  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
  "status": "approved"
}

Sinon, la réponse inclut un link pour terminer le flux visuel standard, exactement comme une transaction créée sans la Vérification silencieuse :

{
  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
  "status": "waiting",
  "link": "https://aces.so/example",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cC[...]Ok6yJV_adQssw5c"
}

Pour tout autre statut, suivez le flux standard en utilisant le link renvoyé — consultez Contrôle de l'expérience et Énumérations pour la liste complète des statuts.

Dernière mise à jour le