Codici di esito della validazione su database

L’API di Validazione su database di Didit interroga il registro civile ufficiale di ciascun paese — RENAPER (Argentina, $0.20/controllo con confronto facciale biometrico), Receita Federal (Brasile, $0.20), Tribunal Electoral SIB (Panama, $0.75 biometrico), Junta Central Electoral (Repubblica Dominicana, $0.05) e altri 14 — con fatturazione per query riuscita, senza minimi mensili. Quando esegui una Validazione su database, ottieni due livelli di risultato:

Un codice di esito standard che funziona allo stesso modo in tutti i paesi supportati, così da consentirti di scrivere un’unica logica di gestione per tutti.
Un codice di dettaglio specifico per paese opzionale che indica esattamente quale condizione ha restituito il registro governativo — utile per l’assistenza, l’analisi e per decidere se invitare l’utente a riprovare.

Questa pagina elenca tutti i valori possibili e illustra come reagire a ciascuno di essi.

Codici di esito standard

Questi codici sono identici per ogni paese. Basa la tua logica di revisione, rifiuto e nuovo tentativo su di essi — non sui codici di dettaglio specifici per paese.

Codice di esito	Significato	Ripetibile?	Gestione consigliata
`MATCH`	Il registro ha confermato l’identità e tutti i campi verificati corrispondevano.	—	Approva.
`PARTIAL_MATCH`	Il registro ha trovato un record, ma uno o più dei campi confrontati dal servizio non corrispondevano completamente (di solito nome o data di nascita). I campi che determinano l’esito variano in base al servizio — vedi Metodi di corrispondenza.	—	Invia a revisione o configura una Partial Match Action per il rifiuto automatico.
`NO_MATCH`	Il registro non ha restituito alcuna corrispondenza per i dati inviati.	No	Rifiuta, o invia a revisione in base alle tue policy.
`DOCUMENT_SUPERSEDED`	Il registro ha confermato l’identità della persona, ma l’edizione del documento presentata non è quella presente nei suoi archivi — nel frattempo è stata emessa un’edizione più recente, quindi il documento in possesso non è più aggiornato. La lettera dell’ejemplar del DNI argentino è il caso tipico. È distinto da `NO_MATCH` (la persona non corrispondeva) e da `DOCUMENT_NOT_FOUND` (nessun record presente): solo il documento fisico non è aggiornato.	No	Invia a revisione e richiedi l’edizione corrente del documento. Segue la tua No Match Action e genera `DATABASE_VALIDATION_DOCUMENT_SUPERSEDED`.
`DOCUMENT_NOT_FOUND`	Il numero del documento di identità è sintatticamente valido ma non esiste nel registro governativo.	No	Rifiuta.
`INVALID_DOCUMENT_FORMAT`	Il numero del documento di identità inviato non è valido (lunghezza errata, caratteri non numerici, checksum errato).	No	Chiedi all’utente di inserire nuovamente il numero del documento.
`INVALID_INPUT`	Un campo obbligatorio di input (selfie, genere, data di nascita, ecc.) era mancante o non valido.	No	Chiedi all’utente di inviare nuovamente il campo mancante. La sessione verrà rielaborata automaticamente una volta forniti i dati — vedi `COULD_NOT_PERFORM_DATABASE_VALIDATION`.
`MINOR_BLOCKED`	Il registro non ha fornito il record perché il soggetto è minorenne. Si applica nelle giurisdizioni con leggi sulla protezione dei dati dei minori (LGPD in Brasile, Argentina).	No	Rifiuta. Rispetta il quadro normativo locale — non effettuare nuovi tentativi.
`DECEASED`	Il registro segnala che il soggetto è deceduto.	No	Rifiuta.
`BIOMETRIC_NO_MATCH`	Per le validazioni biometriche (Argentina, Panama), il punteggio di confronto facciale era inferiore alla soglia di accettazione.	No	Rifiuta, o invia a revisione.
`BIOMETRIC_IMAGE_UNUSABLE`	Impossibile elaborare il selfie — l’immagine era vuota, non conteneva volti, era di bassa qualità o il registro non è riuscito a leggerla.	Sì	Invita l’utente a scattare nuovamente il selfie.
`INCONCLUSIVE`	Il registro non è riuscito a determinare se la persona corrisponde — il risultato è realmente incerto (potrebbe essere o non essere presente nel registro). È distinto da `NO_MATCH` (assente in modo definitivo) e da `BIOMETRIC_IMAGE_UNUSABLE` (un problema tecnico dell’immagine): non è stato confermato nulla in nessun senso, quindi `match_type` è `null`.	Forse	Invia a revisione. Un nuovo tentativo con un selfie più nitido o dati aggiuntivi potrebbe risolvere il problema.
`REGISTRY_UNAVAILABLE`	Il registro governativo è temporaneamente non raggiungibile (timeout, errore di connettività, errore 5xx a monte).	Sì	Riprova dopo un breve intervallo. Didit ritenta già automaticamente gli errori temporanei, quindi vedere questo codice nel report finale significa che i tentativi sono stati esauriti. Quando un registro continua a fallire, la tua organizzazione riceve un’email quando l’interruzione si prolunga e di nuovo quando l’accesso viene ripristinato — vedi Notifiche di disponibilità.
`REGISTRY_ERROR`	Il registro ha restituito un errore imprevisto che non rientra in nessuna delle categorie sopra indicate.	Forse	Scala la richiesta al supporto indicando il codice di dettaglio.

Il campo outcome_code si trova all’interno di ciascuna voce dell’array validations nel report di validazione. Vedi Report di validazione su database per scoprire dove si colloca nella risposta.

REGISTRY_UNAVAILABLE e REGISTRY_ERROR indicano che il registro di origine non ha mai risposto alla query, pertanto questi due esiti non vengono fatturati - vedi prezzi. Ogni altro codice di esito costituisce una risposta reale e a pagamento da parte del registro, anche quella che non conferma nulla (INCONCLUSIVE, BIOMETRIC_IMAGE_UNUSABLE) o quella che rifiuta i dati inviati (INVALID_DOCUMENT_FORMAT, INVALID_INPUT — come codici di esito indicano che il registro stesso ha rifiutato i dati, dopo l’invio della query).I dati di input che non raggiungono mai un registro non generano alcun codice di esito: POST /v3/database-validation/ risponde con 400 quando un valore non rispetta le regole di formato del paese, e un servizio del workflow con campi mancanti o non validi viene ignorato con COULD_NOT_PERFORM_DATABASE_VALIDATION. Nessuno dei due viene fatturato. Il riepilogo completo è disponibile nella pagina dei prezzi della Validazione su database.

Codici di dettaglio specifici per paese

Il codice di dettaglio viene restituito come outcome_detail insieme a outcome_code. Solo i paesi elencati di seguito generano codici di dettaglio oltre all’esito standard: tutti gli altri paesi supportati restituiscono unicamente i codici standard.

Argentina (RENAPER)

L’Argentina utilizza una validazione biometrica 1×1 rispetto al registro di identità nazionale RENAPER, combinando DNI, selfie e genere dichiarato.

Codice di dettaglio	Esito standard	Significato
`300`	`INVALID_DOCUMENT_FORMAT`	Il campo DNI deve essere un numero di 7–8 cifre.
`301`	`DOCUMENT_NOT_FOUND`	Il DNI inviato non corrisponde a un record valido.
`303`	`INVALID_INPUT`	Il campo del selfie era vuoto.
`304`	`INVALID_INPUT`	Il campo del genere era vuoto o diverso da `M`, `F`, `X`.
`305`	`NO_MATCH`	La combinazione di DNI e genere non è stata trovata.
`306`	`REGISTRY_UNAVAILABLE`	Impossibile eseguire l’interrogazione in questo momento.
`307`	`REGISTRY_UNAVAILABLE`	Errore di connessione al sistema pubblico di validazione dell’identità.
`311`	`REGISTRY_ERROR`	L’integrazione non ha accesso a questo prodotto.
`313`	`MINOR_BLOCKED`	Il record appartiene a una persona minorenne.
`400`	`REGISTRY_UNAVAILABLE`	Errore di connessione.
`401`	`NO_MATCH`	Nessun risultato trovato per i dati forniti.
`405`	`BIOMETRIC_IMAGE_UNUSABLE`	Conflitto con l’immagine; impossibile elaborarla.
`406`	`BIOMETRIC_IMAGE_UNUSABLE`	Errore nell’elaborazione dell’immagine.
`NO.HIT`	`BIOMETRIC_NO_MATCH`	Il punteggio di corrispondenza è risultato inferiore alla soglia di accettazione (< 50).
`INTERNAL_ERROR`	`REGISTRY_UNAVAILABLE`	Timeout superato.

Brasile (Receita Federal — Consulta CPF)

Il Brasile valida il CPF rispetto al servizio ufficiale CPF della Receita Federal, con gestione esplicita per i minori ai sensi della LGPD (Lei Geral de Proteção de Dados) e dello Statuto Digitale dei Bambini e degli Adolescenti.

Codice di dettaglio	Esito standard	Significato
`200`	`MATCH`	CPF trovato e dati restituiti con successo.
`206`	`MATCH`	CPF trovato, ma alcuni campi non essenziali non sono stati restituiti.
`400`	`INVALID_DOCUMENT_FORMAT`	Il numero di CPF non è valido.
`404`	`DOCUMENT_NOT_FOUND`	Nessun CPF esistente con il numero inviato.
`422`	`MINOR_BLOCKED`	I dati relativi a un minore di 18 anni sono trattenuti ai sensi della LGPD (Legge 13.709/2018). La risposta include `minor_under_18: true`.
`451`	`MINOR_BLOCKED`	I dati relativi a un minore di 16 anni sono trattenuti ai sensi della LGPD e dello Statuto Digitale dei Bambini e degli Adolescenti (Legge 15.211/2025). La risposta include `minor_under_18: true` e `minor_under_16: true`.
`500`	`REGISTRY_UNAVAILABLE`	Errore del server a monte.
`504`	`REGISTRY_UNAVAILABLE`	Timeout del gateway: la richiesta non ha raggiunto l’API Consulta CPF.

Per gli esiti MINOR_BLOCKED in Brasile, source_data restituisce comunque i flag lgpd_minor, minor_under_18 e minor_under_16 per consentirti di applicare flussi adatti all’età senza dover eseguire nuovi tentativi.

Panama (SIB — Tribunal Electoral)

Panama utilizza la validazione biometrica rispetto al registro SIB (Servicio de Identificación Biométrica) gestito dal Tribunal Electoral. In caso di errore tecnico del SIB, la sessione esegue automaticamente il fallback a una ricerca 1×1.

Codice di dettaglio	Esito standard	Significato
`601`	`REGISTRY_UNAVAILABLE`	L’operatore non esiste nel database.
`602`	`MINOR_BLOCKED`	Il cittadino ha meno di 12 anni.
`603`	`DECEASED`	Il cittadino è deceduto.
`604`	`NO_MATCH`	Il cittadino ha una registrazione non valida.
`605`	`NO_MATCH`	Cittadino non riconosciuto.
`606`	`INVALID_INPUT`	Il campo della Cédula è vuoto.
`607`	`DOCUMENT_NOT_FOUND`	Cittadino non trovato.
`608`	`REGISTRY_ERROR`	Nessun accesso a SIB per questo cliente.
`610`	`BIOMETRIC_IMAGE_UNUSABLE`	Errore generale di validazione facciale.
`611`	`BIOMETRIC_IMAGE_UNUSABLE`	L’immagine per il confronto non è stata inviata.
`612`	`BIOMETRIC_IMAGE_UNUSABLE`	L’immagine non ha contenuto.
`613`	`BIOMETRIC_IMAGE_UNUSABLE`	Formato immagine non valido.
`614`	`BIOMETRIC_IMAGE_UNUSABLE`	Nessun volto rilevato nell’immagine.
`615`	`BIOMETRIC_NO_MATCH`	Soglia di somiglianza non raggiunta.

Altri paesi supportati

I paesi indicati di seguito restituiscono unicamente i codici di esito standard: non ci sono codici di dettaglio specifici per paese da gestire.

Bolivia, Colombia, Costa Rica, El Salvador, Guatemala, Honduras, Paraguay, Spagna, Uruguay, Venezuela — ricerca 1×1 rispetto al registro civile corrispondente. I risultati corrispondono direttamente a MATCH, NO_MATCH, DOCUMENT_NOT_FOUND, INVALID_DOCUMENT_FORMAT o REGISTRY_UNAVAILABLE.
Cile (Registro Civil) — ricerca del RUT. Corrisponde agli esiti standard più MINOR_BLOCKED quando il registro segnala un record minorenne.
Repubblica Dominicana (JCE) — ricerca della Cédula che restituisce una validità booleana; corrisponde a MATCH o NO_MATCH.
Ecuador (Registro Civil) — ricerca della Cédula.
Messico (RENAPO, più INE per 2×2) — ricerca della CURP tramite RENAPO. Quando validation_type è two_by_two, viene eseguito un controllo incrociato aggiuntivo con INE; entrambi confluiscono negli stessi codici di esito standard.
Perù (RENIEC) — ricerca del DNI.

Procedura di gestione

Il gestore più semplice e robusto ha questo aspetto:

switch (result.outcome_code) {
  case "MATCH":
    return approve();
  case "PARTIAL_MATCH":
    return review();
  case "NO_MATCH":
  case "DOCUMENT_NOT_FOUND":
  case "DECEASED":
  case "MINOR_BLOCKED":
  case "BIOMETRIC_NO_MATCH":
    return decline();
  case "INVALID_DOCUMENT_FORMAT":
  case "INVALID_INPUT":
    return askUserToFixInput(result.outcome_detail);
  case "BIOMETRIC_IMAGE_UNUSABLE":
    return askUserToRetakeSelfie();
  case "REGISTRY_UNAVAILABLE":
  case "REGISTRY_ERROR":
    return review();  // Didit already retried; a human can decide.
  default:
    return review();
}

Non è necessario creare diramazioni su outcome_detail per la logica di business: usalo per l’analisi, il debug e i ticket di assistenza. La stabilità dell’outcome_code standard è garantita tra i diversi paesi e nel tempo.

Vedi anche

Database Validation Warnings: i tag di avviso a livello di sessione (COULD_NOT_PERFORM_DATABASE_VALIDATION, DATABASE_VALIDATION_PARTIAL_MATCH, DATABASE_VALIDATION_NO_MATCH) e come configurare le azioni di revisione/rifiuto della tua applicazione.
Database Validation Report: la struttura completa della risposta e dove compaiono outcome_code / outcome_detail.
Database Validation Supported Countries: l’elenco completo dei paesi e dei metodi di corrispondenza.

Autenticazione

Verifica

Monitoraggio

Piattaforma

Codici di esito della validazione su database

Codici di esito standard

Codici di dettaglio specifici per paese

Argentina (RENAPER)

Brasile (Receita Federal — Consulta CPF)

Panama (SIB — Tribunal Electoral)

Altri paesi supportati

Procedura di gestione

Vedi anche

​Codici di esito standard

​Codici di dettaglio specifici per paese

​Argentina (RENAPER)

​Brasile (Receita Federal — Consulta CPF)

​Panama (SIB — Tribunal Electoral)

​Altri paesi supportati

​Procedura di gestione

​Vedi anche

Codici di esito standard

Codici di dettaglio specifici per paese

Argentina (RENAPER)

Brasile (Receita Federal — Consulta CPF)

Panama (SIB — Tribunal Electoral)

Altri paesi supportati

Procedura di gestione

Vedi anche