Human Token

Human Token est conçu pour les scénarios où il n'existe pas de relation avec un document officiel — situations où les clients souhaitent éviter de partager leur numéro de document pour des raisons de confidentialité. Sa fonction principale est de créer une identité unique pour chaque visage à partir d'un seul envoi de selfie.

Cela vous permet de :

• Détecter les utilisateurs récurrents et prévenir les comptes en double — reconnaître si la même personne revient ou tente de créer plusieurs comptes, garantissant une reconnaissance d'identité cohérente sans documents officiels.
• Intégrer via Web, Native ou API — en utilisant uniquement l'image de selfie comme entrée, sans données de document supplémentaires requises.
• Combiner avec d'autres signaux — ajouter Human Token aux côtés d'autres capacités selon les besoins.

Ce que cela fait

À partir du selfie capturé, Human Token génère un identifiant biométrique stable et opaque (personId) qui représente ce visage de manière unique. L'utilisateur ne déclare aucun identifiant — l'identité est le résultat de l'appel, non l'entrée. À chaque correspondance réussie, la réponse retourne le même personId, permettant de reconnaître le même utilisateur lors de processus futurs.

Entrées

Le selfie est capturé par le SDK ou le Web Journey. Pour une intégration API sans interface, l'image est envoyée sous forme d'imagebase64 dans le corps de POST /processes/v1. N'incluez pas subject.code — Human Token retourne le personId dans la réponse.

SDK requis pour une capture de qualité

Pour garantir que l'image envoyée via API répond aux exigences biométriques, utilisez le SDK Unico pour votre plateforme ou suivez le Standard de capture. Human Token n'accepte pas d'images arbitraires sans contrôle de qualité à la capture.

Réponses possibles

idFace.result	Signification
FOUND	Identité résolue. personId est retourné et renseigné.

Lorsqu'aucun personId ne peut être généré

Il existe un seul scénario où Human Token ne produit pas de personId : le visage ne peut pas être identifié dans l'image soumise — aucun visage n'est détecté, la qualité de l'image est trop faible, ou le visage ne respecte pas le standard de capture (incliné, tourné de côté). Ce n'est pas une valeur de result : la requête échoue avec 20532 — No face detected in image. Suivre le Standard de capture permet de l'éviter.

Exemple de réponse

{
  "id": "1c1fc38b-7e98-4f9a-a04d-7a4a8b29d2c1",
  "status": 3,
  "idFace": {
    "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
    "result": "FOUND"
  }
}

personId est un identifiant stable et opaque — le même utilisateur résoudra toujours la même valeur. Stockez-le avec votre enregistrement utilisateur pour reconnaître la même personne lors des appels Human Token ultérieurs.

Disponibilité

Surface	Pris en charge
SDK (Android, iOS, Flutter)	✅
Web (iFrame, Redirect)	✅
API (sans interface, sans SDK)	✅