---
title: Retraitement et importation de base biométrique
description: Guide pour le retraitement de registres biométriques ou l'importation d'une base biométrique sur la plateforme Unico.
canonical: https://developer.unico.io/fr/dual-api/resources/reprocessing
locale: fr
generated_by: markdown-export
---

- [/fr/](/fr/)
- Ressources
- Retraitement et importation de base biométrique

**Sur cette page# Retraitement et importation de base biométrique

Ce guide explique comment effectuer un **retraitement** ou une **importation de base biométrique** sur la plateforme Unico. Il détaille les exigences techniques et opérationnelles pour une intégration efficace et sécurisée, conforme aux bonnes pratiques de la plateforme.
### Périmètre​

Ce document couvre deux types de processus :

**Retraitement** : retraitement des registres biométriques d'utilisateurs déjà passés par la base du client et d'Unico, en vue d'une réévaluation ou d'une migration entre systèmes.
**Importation de base biométrique** : chargement initial ou mise à jour d'une base contenant des selfies à des fins de vérification d'identité et/ou de classification du risque de fraude.
**Importation de base de documents** : chargement d'une base de documents accompagnée de selfies à des fins de vérification par Facematch ou CPF Match (Brésil uniquement).

### Prérequis​

Le client **doit disposer d'un contrat actif ou d'un accord de confidentialité (NDA)** signé avec Unico et être en phase d'intégration (exception si approuvé par l'équipe de gouvernance).
Le projet suivra des **accords formels de TPS (transactions par seconde)**. Voir [Accord TPS](#tps-agreement) ci-dessous.
Avant d'obtenir les identifiants de production, **l'homologation complète de l'intégration est obligatoire** pour garantir la qualité des données, la conformité du payload et la stabilité des performances.
Un **compte de service dédié** doit être créé pour le retraitement ou l'importation (ex. : "Reprocessing" ou "Legacy_Import").
Une **clé API dédiée** sera créée spécifiquement pour le retraitement/importation.
**(Optionnel)** Une filiale dédiée peut être créée pour le retraitement/importation. Ce paramètre est identifié dans le payload par `subsidiaryId`. Voir [Paramètres du payload](#payload-parameters) ci-dessous.
La clé API et le compte de service **seront désactivés** après la période convenue ou à la fin du traitement.

### Capacités disponibles​

CapacitéDescription**Vérification d'identité**Vérifie si le selfie soumis appartient au véritable titulaire de l'identifiant.**Classification du risque de fraude**Vérifie s'il existe un historique de comportement frauduleux associé à ce visage.**Facematch**Vérifie si la photo du document correspond au selfie soumis.**CPF Match** Brazil onlyVérifie si le CPF fourni correspond au numéro CPF imprimé sur le document. Remarque : tous les RGs n'ont pas le CPF imprimé.
### Exigences relatives aux selfies​

Le selfie doit être soumis au format **base64**.
L'image doit respecter la **norme ICAO** (fond clair, visage centré, pas d'accessoires obstruant l'identification, éclairage adéquat).
Dimensions recommandées : **1080x1920** (portrait) ou **1920x1080** (paysage).
Taille maximale : **800 Ko** (compresser en JPEG 92 si nécessaire).
Orientation : **portrait**.

### Exigences relatives aux documents​

**Types de documents pris en charge** : voir [Capture de documents et réutilisation — Documents pris en charge](/fr/capabilities/document-reuse-and-capture#supported-documents).
Les images doivent inclure à la fois le **recto et le verso** du document, entièrement visibles sans rognage.
Le document doit être **lisible** — clair, bien éclairé et sans obstruction.

### Accord TPS​

Le TPS maximum convenu pour ce projet est de **10 TPS**.
Répartissez les requêtes uniformément dans le temps plutôt que de les envoyer par rafales massives.
Cette limite **ne doit pas être dépassée** sans approbation formelle de l'équipe Unico.
Les requêtes au-delà de la limite peuvent être automatiquement rejetées ou bloquées.
Si une augmentation temporaire est nécessaire, un **accord formel préalable** est requis.

### Intégration​

#### Endpoints​

EnvironnementURL de baseAccèsNotesStaging`https://api.id.uat.unico.app`OuvertObligatoire pour les testsProduction`https://api.id.unico.app`Uniquement après homologation approuvéeNécessite un contrôle strict du TPS
#### En-têtes requis​

```
Authorization: Bearer {access_token}APIKEY: {your_api_key}Content-Type: application/json
```

#### Paramètres du payload​

```
{  "subject": {    "duiType": 1,    "code": "11032395702",    "name": "User Name",    "email": "username@gmail.io",    "phone": "21998571922",    "birthDate": "30/07/1989",    "gender": "M"  },  "useCase": "Reprocessamento/Importação",  "subsidiaryId": "35d734c4-7fbb-4b2f-a1dc-7e1575514819",  "imageBase64": "/9j/4AAQSkZJR...",  "document": {    "purpose": "Reprocessamento",    "documentId": "doc-001",    "files": [      {        "data": "doc_base64_frente",        "faceDocumentMatch": true      },      {        "data": "doc_base64_verso"      }    ]  }}
```

ChampTypeRequisDescription`subject`objectOuiDonnées d'identification de l'utilisateur.`subject.duiType`integerOuiIdentifiant du type de document. Voir [valeurs de `duiType`](#duitype-values) ci-dessous.`subject.code`stringOuiCPF ou autre identifiant utilisateur.`subject.name`stringOuiNom complet de l'utilisateur.`subject.email`stringNonAdresse e-mail de l'utilisateur.`subject.phone`stringNonNuméro de téléphone de l'utilisateur.`subject.birthDate`stringNonDate de naissance de l'utilisateur (`DD/MM/YYYY`).`subject.gender`stringNonGenre de l'utilisateur (`M` ou `F`).`useCase`stringOuiNom du cas d'utilisation ("Reprocessamento" ou "Importação de base").`subsidiaryId`stringNonUUID de la filiale (fourni par Unico).`imageBase64`base64OuiImage selfie de l'utilisateur convertie en base64.`document`objectNonDonnées du document associé au processus.`document.purpose`stringNonObjet du document (ex. : `"Reprocessamento"`).`document.documentId`stringNonIdentifiant du document.`document.files`arrayNonListe des fichiers d'images du document.`document.files[].data`base64NonImage du document convertie en base64.`document.files[].faceDocumentMatch`booleanNonIndique si le visage dans le document correspond au selfie soumis.
**Valeurs de `duiType`**PaysCodeDescriptionAR6Passeport argentinAR7DNI argentinAR49Permis de conduire argentin (Licencia Nacional de Conducir)AT34Numéro fiscal autrichien (STNR)BE36Numéro national belge (NN)BR1CPF brésilienBR5Passeport brésilienBR14CNPJ brésilienCA28Numéro d'assurance sociale canadien (NAS)CH33Numéro AVS/AHV suisseCL9RUN chilienCL52Passeport chilienCL57Permis de conduire chilien (Licencia de Conducir)CO26NIT colombienCO53Passeport colombienCO55Permis de conduire colombien (Licencia de Conducción)CO56Carte de citoyenneté colombienne (Cédula de Ciudadanía)DE41Numéro d'identification fiscale allemand (IdNr)DK29CPR danoisEC10NI équatorienES50Numéro d'identité d'étranger espagnol (NIE)ES51Document national d'identité espagnol (DNI)FI35Code d'identité personnelle finlandais (HETU)FR46Numéro de référence fiscale français (SPI)GB30Numéro d'assurance nationale britannique (NINO)GT12CUI guatémaltèqueID16NIK indonésienIE47Numéro personnel de service public irlandais (PPSN)IT37Codice Fiscale italien (CF)LU48Numéro d'identification national luxembourgeois (Matricule)MX2CURP mexicainMX25RFC mexicain (Personne physique)MX58Permis de conduire mexicain (Licencia de Conducir)NG8NIN nigérianNG20Numéro de vérification bancaire nigérian (BVN)NG43Jeton BVN nigérian (haché)NG44Jeton NIN nigérian (haché)NL42Numéro de service citoyen néerlandais (BSN)NO39Numéro d'identité national norvégien (Fødselsnummer)PE27RUC péruvienPE40DNI péruvienPE54Passeport péruvienPL31PESEL polonaisPT45Numéro d'identification fiscale portugais (NIF)SE32Numéro personnel suédois (PNR)SE38Numéro de coordination suédois (Samordningsnummer)TR24Numéro d'identification turc (TCKN)US4SSN américainUS11Passeport américainUS18Permis de conduire américainUS21Carte de passeport américaineUS22Passeport américain en polycarbonateUS23Carte d'identité américaineUY13CI uruguayenZZ15Adresse e-mailZZ17Numéro de téléphone—0Non spécifié—3Identifiant interne Unico
#### Notes importantes​

Le selfie **doit être conforme à la norme ICAO** avec une qualité et un éclairage adéquats.
Le selfie doit être au format **base64**.
Évitez les envois massifs sans contrôle du TPS -- cela peut déclencher une limitation de débit (voir [Gestion des erreurs](#error-handling) ci-dessous).
Testez toujours les données et l'intégration dans l'environnement de staging au préalable.

#### Réponses​

**Succès -- 200 OK**
Sans documentAvec document (Facematch)```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "status": 3,  "unicoId": {    "result": "inconclusive"  },  "identityFraudsters": {    "result": "inconclusive"  }}
```

ChampTypeDescription`id`stringIdentifiant du processus. Conservez-le pour des requêtes futures ou si vous implémentez la Validation (1:1) ultérieurement.`status`integerStatut de la transaction.`unicoId.result`stringRéponse de la capacité Vérification d'identité.`identityFraudsters.result`stringRéponse de la capacité Classification du risque de fraude.```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "score": 0,  "status": 3,  "unicoId": {    "result": "yes"  },  "faceDocumentMatch": {    "faceMatch": true  },  "identityFraudsters": {    "result": "yes"  }}
```

ChampTypeDescription`id`stringIdentifiant du processus. Conservez-le pour des requêtes futures ou si vous implémentez la Validation (1:1) ultérieurement.`status`integerStatut de la transaction.`score`numberScore Facematch.`unicoId.result`stringRéponse de la capacité Vérification d'identité.`faceDocumentMatch.faceMatch`booleanSi la photo du document correspond au selfie soumis.`identityFraudsters.result`stringRéponse de la capacité Classification du risque de fraude.
**Erreur de traitement d'image**
```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "status": 5}
```

**Erreurs courantes**
Les codes dans la plage `4xx` indiquent des erreurs de validation des données fournies. Les codes dans la plage `5xx` indiquent des défaillances côté serveur.
Code HTTPType d'erreurCause probableAction recommandée`400`Bad RequestPayload invalideValidez la structure et le contenu.`401`UnauthorizedToken expiré ou invalideRégénérez le token.`403`ForbiddenClé API incorrecte ou permissions insuffisantesVérifiez les identifiants.`429`Too Many RequestsDébit de requêtes dépasséAttendez et respectez la limite TPS.`500+`Internal Server ErrorDéfaillance interneRéessayez après quelques secondes ; ouvrez un ticket si le problème persiste.
### Gestion des erreurs​

Le **Rate Limit (HTTP 429)** doit être surveillé attentivement. Une surcharge de requêtes peut bloquer le pipeline.
Respectez toujours le TPS convenu avec Unico (voir [Accord TPS](#tps-agreement)).
Pour les défaillances persistantes (5xx), retraitez avec un contrôle de retry/backoff.
Dernière mise à jour le 8 oct. 2026**