Vai al contenuto principale
POST
Verifica un numero di identificazione nazionale nigeriano (NIN) nel registro della National Identity Management Commission. Richiede un selfie: il ritratto di registrazione associato al NIN viene confrontato con il selfie, e il record viene restituito solo quando i due appartengono alla stessa persona. Didit espone questo servizio tramite POST /v3/database-validation/, così puoi verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati.

Copertura

  • Copertura: ~ 100%
  • Paese: Nigeria
  • ID servizio: nga_national_id_facial
  • Dominio dei dati: Identità
  • Categoria: NationalIDRegistry

Input

  • Input obbligatori: national_id, selfie
  • Input facoltativi: first_name, last_name, date_of_birth, vendor_data
  • Consenso: non richiesto
  • Disponibilità nel workflow: disponibile nel workflow
  • Copertura: ~ 100%
  • Prezzo: $0.35 per query riuscita
Non tutti i documenti accettati da questo servizio contengono l’identificativo con cui il servizio effettua la ricerca. Quando l’identificativo non viene estratto dal documento, il controllo viene registrato come non applicabile: non viene interrogato alcun database e non ti viene addebitato nulla. Per alcuni paesi questo riguarda una quota rilevante degli utenti reali. Per coprirli, raccogli l’identificativo anche da una risposta di un Questionario, da un campo estratto da Document AI o da un valore che invii alla creazione della sessione, e mappalo nel passaggio Validazione su database.

Parametri del body

string
predefinito:"NGA"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: NGA
string
predefinito:"nga_national_id_facial"
obbligatorio
Array che contiene l’ID di questo servizio. Specificare il servizio vincola la richiesta a questo database.Esempio: nga_national_id_facial
string
predefinito:"11111111111"
obbligatorio
Numero di identificazione nazionale per questo servizio.Esempio: 11111111111
file
obbligatorio
File immagine del selfie da caricare per la validazione biometrica su database. Formati accettati: JPEG, PNG o WebP.Esempio: @./selfie.jpg
string
Nome di battesimo da verificare.Esempio: John
string
Cognome da verificare.Esempio: Doe
string
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare le verifiche indipendenti allo stesso utente finale e ridurre il rumore del rilevamento dei duplicati.Esempio: user-1234

Regole di input e note di validazione

  • first_name deve corrispondere a [A-Za-zÀ-ÖØ-öø-ÿ .'-]+.
  • national_id deve contenere solo cifre: rimuovi spazi, trattini e punteggiatura prima di inviare la richiesta.
  • national_id deve essere lungo esattamente 11 caratteri.

Come effettuare la chiamata

Dati restituiti

I campi esatti esposti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per nga_national_id_facial documenta attualmente questa struttura normalizzata:
  • address
  • birth_country
  • birth_lga
  • birth_state
  • date_of_birth
  • face_match_score
  • first_name
  • gender
  • identification_number
  • last_name
  • marital_status
  • middle_name
  • phone_number
  • photo_available
  • residence_lga
  • residence_state
  • residence_town

Prezzi e SLA

Le query Nigeria National ID + Selfie (NIMC) vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di verifica.
  • Prezzo per chiamata: $0.35 USD.
  • Fatturazione: per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
  • Latenza: p95 tipico < 2 s.
  • Disponibilità: 99.9% per trimestre dal lato di Didit; la disponibilità delle fonti a valle varia in base al paese e al dataset.

Selfie e confronto facciale

Il registro NIMC restituisce l’intero record del titolare per un NIN valido, quindi conoscere un numero non dimostra di esserne il titolare. Per questo ogni ricerca è legata a un selfie: il selfie viene confrontato con la foto di registrazione che NIMC conserva per quel NIN, e il record viene restituito solo quando si tratta della stessa persona.
  • Corrispondenza: source_data contiene il record NIMC e face_match_score. Nome e data di nascita che invii vengono confrontati con quelli del registro e riportati in validation; inviali per ottenere l’esito su nome e data di nascita, oppure omettili e leggi i valori del registro in source_data.
  • Persona diversa: BIOMETRIC_NO_MATCH. Viene restituito solo face_match_score, senza dati personali.
  • Confronto non possibile: INCONCLUSIVE quando NIMC non dispone di una foto per il NIN o quando non è stato possibile rilevare un volto. Non viene restituito nulla e la verifica viene inviata in revisione.
  • NIN sconosciuto: DOCUMENT_NOT_FOUND. La ricerca viene comunque fatturata.
In un workflow, il selfie viene preso dal passaggio di rilevamento della vitalità o di confronto facciale, oppure dal ritratto presente sul documento caricato quando il workflow non prevede un passaggio facciale. Una richiesta senza selfie, o con un NIN che non è composto da 11 cifre, viene rifiutata prima di qualsiasi addebito.

Continua a leggere

Ultima modifica il 7 novembre 2026