Passer au contenu principal
POST
Vérifie le DNI argentin auprès du registre d’état civil officiel RENAPER, avec une correspondance faciale biométrique par rapport à la photo enregistrée. Couverture de 100% de la population. Didit expose ce service via POST /v3/database-validation/ afin de vérifier les données soumises auprès de la source faisant autorité et de recevoir des résultats de correspondance normalisés. Format de saisie : document_number accepte le DNI argentin (7 à 8 chiffres, préfixe M/F facultatif).

Couverture

  • Couverture : 100%
  • Pays : Argentine
  • Identifiant du service : arg_renaper
  • Domaine de données : Identité
  • Catégorie : NationalIDRegistry
RENAPER est le registre qui délivre chaque DNI argentin. Chaque numéro de DNI figure donc dans ses fichiers, y compris les DNI délivrés aux résidents étrangers. La correspondance faciale compare le selfie à la photo que RENAPER détient pour ce DNI.

Entrées

  • Entrées obligatoires : document_number, selfie, gender
  • Entrées facultatives : first_name, last_name, date_of_birth, vendor_data
  • Consentement : non requis
  • Disponibilité dans le workflow : disponible dans un workflow
  • Couverture : 100%
  • Prix : $0.20 par requête réussie

Paramètres du corps de requête

string
défaut:"ARG"
requis
Code pays ISO 3166-1 alpha-3 de ce service de base de données.Exemple : ARG
string
défaut:"arg_renaper"
requis
Tableau contenant l’identifiant de ce service. Épingler le service limite la requête à cette base de données précise.Exemple : arg_renaper
string
défaut:"11111111"
requis
Numéro de document extrait ou fourni par l’utilisateur.Exemple : 11111111
file
requis
Fichier image de selfie à téléverser pour la validation biométrique en base de données. Formats acceptés : JPEG, PNG ou WebP.Exemple : @./selfie.jpg
string
défaut:"M"
requis
Valeur du genre, lorsque la base de données l’exige.Valeurs autorisées : M (homme), F (femme), X (autre ou inconnu).Exemple : M
string
Prénom à valider.Exemple : John
string
Nom de famille à valider.Exemple : Doe
string
Date de naissance au format YYYY-MM-DD.Exemple : 1990-01-01
string
défaut:"user-1234"
Votre référence utilisateur stable pour cette personne, par exemple votre identifiant utilisateur interne. Didit s’en sert pour relier les vérifications autonomes au même utilisateur final et réduire le bruit de détection des doublons.Exemple : user-1234

Règles de saisie et notes de validation

  • DNI argentin (7 à 8 chiffres, préfixe M/F facultatif)
  • document_number doit comporter entre 7 et 9 caractères.
  • document_number doit correspondre à [MFmf]?\d{7,8}.

Comment l’appeler

Données renvoyées

Les champs exacts présents dans source_data dépendent de ce que renvoie le registre. L’exemple généré pour arg_renaper documente actuellement cette forme normalisée :
  • date_of_birth
  • face_match_score
  • first_name
  • full_name
  • identification_number
  • last_name
  • tax_id
  • tax_id_type

Tarifs et SLA

Argentine : les requêtes de vérification du DNI (RENAPER) ne sont facturées que lorsque Didit reçoit un résultat concluant de la source de validation.
  • Prix par appel : $0.20 USD.
  • Facturation : par requête réussie. Vous n’êtes pas facturé lorsque le registre est injoignable, lorsque des champs obligatoires manquent ou lorsque la requête est rejetée avant d’atteindre la source.
  • Latence : p95 typique < 2 s.
  • Disponibilité : 99.9% par trimestre côté Didit ; la disponibilité des sources en aval varie selon le pays et le jeu de données.

Score de correspondance faciale

face_match_score est la similarité calculée par RENAPER entre le selfie et la photo enregistrée pour le DNI. Il est transmis sous la forme d’un nombre entier de 0 à 100, dans une chaîne, par exemple "92". Ce n’est pas une probabilité comprise entre 0 et 1. La vérification renvoie BIOMETRIC_NO_MATCH lorsque RENAPER indique que le visage ne correspond pas, ou lorsque le score est inférieur à 50. À partir de 50, le visage est accepté, et le nom et la date de naissance enregistrés sont alors comparés aux données que vous avez transmises. La photo enregistrée peut dater de plusieurs années. Un utilisateur légitime peut donc obtenir un score faible après un changement important de son apparence. Envisagez de soumettre BIOMETRIC_NO_MATCH à un examen manuel plutôt que de le refuser directement, avec les actions Partial Match / No Match.

Quand RENAPER ne répond pas

Si RENAPER est injoignable ou répond par une erreur, le résultat est REGISTRY_UNAVAILABLE : aucune information sur la personne n’a été vérifiée, et l’appel n’est pas facturé. La même requête peut aboutir si vous la renvoyez plus tard. Consultez Codes de résultat pour savoir comment la traiter.

Documents lus par un workflow

Dans un workflow, le numéro de DNI et le genre proviennent de l’étape Vérification d’identité, qui lit la carte DNI argentine et le DNI numérique. Les résidents étrangers disposent de la même carte DNI et sont vérifiés de la même manière. Le DNI sous forme de livret (libreta) n’est pas un document pris en charge par la Vérification d’identité : un utilisateur qui ne possède que ce document ne peut pas terminer cette étape. Vous pouvez tout de même contrôler directement son numéro de DNI avec POST /v3/database-validation/.

Utilisation dans un workflow

Ajoutez le service à une étape Validation en base de données après la Vérification d’identité. Par exemple, avec POST /v3/workflows/ :
Si une étape de détection du vivant la précède, RENAPER compare le selfie en direct. Sans elle, Didit envoie à la place le portrait imprimé sur le document d’identité. Cela confirme la photo du document, mais pas que la personne face à la caméra en est bien le titulaire. Un identifiant de service que le workflow ne peut pas exécuter est rejeté avec un code 400 qui le nomme : l’étape n’est donc jamais enregistrée sans le contrôle demandé. Consultez Configurations des fonctionnalités du workflow pour tous les paramètres de Validation en base de données.

Pour aller plus loin

Dernière modification le 7 novembre 2026