API de vérification DNI/NIE en Espagne : Guide complet (FR)

L'intégration d'utilisateurs en Espagne implique de confirmer leur identité. Didit vérifie les DNI/NIE espagnols par rapport aux registres de la Dirección General de la Policía. Un document ou une information saisie prouve que les données existent, mais pas qu'elles sont authentiques ou qu'elles appartiennent à la personne. La vérification DNI/NIE en Espagne comble cette lacune en comparant les données avec le registre officiel d'identité du gouvernement. Ce guide explique le fonctionnement de la vérification, les détails techniques exacts et comment l'intégrer en quelques minutes.

Points clés :

• Ce qui est vérifié — La vérification DNI/NIE en Espagne valide l'identité nationale par rapport au registre d'identité officiel du gouvernement.
• Ce que vous obtenez — un match_type normalisé ainsi que des résultats détaillés par champ que vous pouvez directement intégrer dans votre logique d'approbation/révision/rejet.
• Pourquoi c'est important — Un document peut être falsifié ; un enregistrement de registre non. La validation de l'identité par rapport à la source gouvernementale faisant autorité confirme que le titulaire est réel et correctement identifié.
• Comment l'utiliser — un seul POST vers le point de terminaison de validation de base de données de Didit, ou un module de flux de travail sans code. 0,20 $ par requête concluante, résultats en quelques secondes.

Ce que la vérification DNI/NIE en Espagne valide

Didit vérifie les DNI/NIE espagnols par rapport aux registres de la Dirección General de la Policía. Didit l'expose via un point de terminaison unique afin que vous puissiez vérifier les données soumises par rapport au registre d'identité officiel du gouvernement et recevoir un résultat structuré et normalisé — pas un dump de registre brut que vous auriez à analyser vous-même.

Une réponse concluante renvoie le source_data correspondant et un bloc validation par champ, afin que votre moteur de risque reçoive un verdict clair et lisible par machine.

Pourquoi c'est important

Un document peut être falsifié ; un enregistrement de registre non. La validation de l'identité par rapport à la source gouvernementale faisant autorité confirme que le titulaire est réel et correctement identifié.

Pour les entreprises réglementées en Espagne — fintechs, plateformes crypto, prêteurs, marketplaces et opérateurs de jeux — la vérification par rapport à une source faisant autorité produit un enregistrement défendable et auditable que l'identité a été confirmée à la source, et non simplement capturée à partir d'un formulaire ou d'une photo.

Détails techniques

Didit expose ce service via le point de terminaison unifié de validation de base de données. Il s'agit d'un simple POST — aucun SDK n'est requis.

Point de terminaison

POST /v3/database-validation/

Paramètres de la requête

Paramètre	Type	Requis	Description
issuing_state	string	Oui	Code pays ISO 3166-1 alpha-3. Utilisez ESP.
services	string	Oui	Identifiant de service. Utilisez esp_dni.
personal_number	string	Oui	Numéro personnel.
document_type	string	Oui	Type de document.
expiration_date	string	Oui	Date d'expiration.
first_name	string	Non	Prénom (vérification croisée facultative).
last_name	string	Non	Nom de famille (vérification croisée facultative).

Exemple de requête

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ESP" \
  -F "services=esp_dni" \
  -F "personal_number=1111111" \
  -F "document_type=sample_value" \
  -F "expiration_date=1990-01-01"

Exemple de réponse (correspondance concluante)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ESP",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "esp_dni",
      "service_name": "Spain - DNI/NIE verification",
      "source_data": {
        "document_type": "sample_value",
        "expiration_date": "1990-01-01",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Performances et facturation

• Latence : généralement quelques secondes.
• Coût : 0,20 $ par requête concluante. Vous n'êtes facturé que sur les résultats concluants — aucun frais pour les temps d'arrêt de la source, les champs manquants ou les rejets avant la source.
• Fiabilité : fonctionne sur l'infrastructure de Didit avec un objectif de disponibilité trimestrielle de 99,9 %.

Cas d'utilisation

• Fintech et néobanques — confirmez qu'un titulaire de compte réel et vérifiable avant d'ouvrir un portefeuille ou d'accorder un crédit en Espagne.
• Crypto et Web3 — répondez aux exigences d'intégration VASP avec une preuve d'identité provenant d'une source faisant autorité.
• Prêt — réduisez la fraude d'identité synthétique et de première partie avec des données vérifiées à la source.
• Marketplaces et plateformes de services — vérifiez les utilisateurs par rapport à des données faisant autorité, pas seulement un formulaire auto-déclaré.
• iGaming — satisfaites aux contrôles d'identité et d'éligibilité pour les joueurs espagnols avec une trace auditable.

Comment intégrer Didit

Vous pouvez exécuter la vérification DNI/NIE en Espagne de deux manières :

1. Flux de travail sans code. Dans la console Didit Business, ouvrez le Workflow Builder, ajoutez le module Validation de base de données, sélectionnez Espagne → Vérification DNI/NIE en Espagne et activez-le. Les utilisateurs correspondants sont acheminés automatiquement — aucune ingénierie requise.
2. API directe. Appelez le point de terminaison /v3/database-validation/ indiqué ci-dessus avec services=esp_dni. Lisez match_type et le bloc validation par champ pour piloter votre logique d'approbation/révision/rejet.

Chaque compte Didit comprend 500 vérifications gratuites par mois, afin que vous puissiez tester le flux complet de bout en bout avant de payer une seule requête.

Questions fréquemment posées

Que confirme la vérification DNI/NIE en Espagne ?

Elle valide les données soumises par rapport au registre d'identité officiel du gouvernement et renvoie un résultat de correspondance normalisé, afin que vous sachiez si l'identité nationale existe à la source faisant autorité et quels champs correspondent.

Que se passe-t-il si la source est temporairement indisponible ?

Vous n'êtes pas facturé. La facturation ne s'applique qu'aux résultats concluants — les temps d'arrêt de la source, les champs manquants et les rejets avant la source sont gratuits.

Quelle est la rapidité de la vérification ?

La validation de la base de données renvoie généralement en quelques secondes, elle s'intègre donc dans un flux d'intégration en temps réel.

Ai-je besoin d'un SDK ?

Non. La vérification est un simple POST HTTPS vers un seul point de terminaison. Vous pouvez également l'intégrer dans un flux de travail sans code dans la console Business.

Prêt à commencer ?

Validez votre première identité nationale espagnole dès aujourd'hui.

• Lisez la référence de l'API : Vérification DNI/NIE en Espagne
• Voir toutes les validations de base de données : Tarifs et couverture de la validation de base de données
• Commencez à créer : Créez un compte Didit gratuit — 500 vérifications par mois, gratuites.