Vue d'ensemble
Choisir un contrat
Le choix du contrat est une conséquence de l'endroit où la capture biométrique se produit — et non une décision indépendante. Utilisez le tableau ci-dessous comme guide.
| Contrat | Utiliser quand… | Capture | Flux |
|---|---|---|---|
| Web & SDK | Le parcours de capture est hébergé par Unico (iFrame Web, Redirection ou SDK natif) | Unico contrôle | Le processus est créé avant la capture → l'utilisateur suit le parcours → le résultat est retourné via callback ou polling |
| API | Votre application contrôle la capture (avec ou sans le SDK Unico) et envoie l'image directement dans l'appel | Le client contrôle | L'image est envoyée avec la création du processus → le résultat est retourné de manière synchrone |
Hôtes et environnements
| Contrat | Hôte sandbox | Hôte de production |
|---|---|---|
| Web & SDK | https://api.idcloud.uat.unico.app | https://api.idcloud.unico.app |
| API | https://api.id.uat.unico.app | https://api.id.unico.app |
| OAuth2 / Token | https://identityhomolog.acesso.io | https://identity.acesso.io |
Détails complets dans Environnements.
Authentification
Tous les contrats Unico utilisent un jeton Bearer (JWT) obtenu via OAuth2 avec urn:ietf:params:oauth:grant-type:jwt-bearer.
Détails complets dans Authentification.
Différences de payload entre les contrats
La même opération conceptuelle (« créer un processus de vérification d'identité ») a un aspect différent selon les contrats. Utilisez les tableaux ci-dessous comme référence rapide lors des migrations entre intégrations.
Création du processus
| Aspect | Web & SDK | API |
|---|---|---|
| Point de terminaison | POST /client/v1/process | POST /processes/v1 |
| Auth | Authorization: Bearer <jwt> | Authorization: Bearer <jwt> + APIKEY |
| Image | Non envoyée (capturée par le parcours Unico) | Envoyée sous forme imageBase64 |
| Identification de l'utilisateur | person.duiType + person.duiValue | subject.code (CPF / CURP) |
| Types de documents | CPF, CURP, SSN, NIN, DNI, NIK | CPF, CURP uniquement |
| Définition du pipeline | flow (enum, 30+ valeurs) | Implicite dans APIKEY (capacités) |
| Callback | callbackUri (redirection utilisateur) | Aucun (synchrone) |
| Webhook | Webhook v1 (résultat final) | Webhook v1 (optionnel) |
| Retourne l'URL du parcours | Oui (userRedirectUrl) | Non |
| Résultat | Asynchrone (polling GET ou webhook) | Synchrone (dans la réponse) |
| Jeton SDK | Oui (token, webAppToken) | Non |
Récupération des résultats
| Aspect | Web & SDK | API |
|---|---|---|
| Point de terminaison | GET /client/v1/process/\{id\} | GET /processes/v1/\{id\} (également dans la réponse de création) |
| Statut | state + result (enums préfixés) | status (1, 3, 5) |
| Structure du résultat | Imbriquée sous process.authenticationInfo.{capability}Result | Plate : unicoId, liveness, government, identityFraudsters |
| Document | services[].documents[] (RG/CNH avec OCR) | Point de terminaison séparé (GET /processes/v1/\{id\}/document) |
Étapes suivantes
- Authentification — flux OAuth2 et génération JWT
- Environnements — sandbox vs production
- Collection Postman — collections prêtes à l'emploi
- Webhooks et événements — livraison asynchrone des résultats
- SDK et outils — Web SDK, Android, iOS, Flutter