Vai al contenuto principale
POST
Verifica i dati di input rispetto ai dati dell’intestazione creditizia ottenuti da un ufficio informazioni creditizie in Italia. 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: ~ 80%
  • Paese: Italia
  • ID servizio: ita_credit_bureau
  • Dominio dei dati: Finanziario
  • Categoria: CreditBureau

Input

  • Input obbligatori: first_name, last_name, address.street_1, address.postal_code, tax_number
  • Input facoltativi: date_of_birth, address.street_2, address.city, address.region, vendor_data
  • Consenso: Non richiesto
  • Disponibilità nel workflow: Disponibile nel workflow
  • Copertura: ~ 80%
  • Prezzo: $3.25 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: nessun database viene interrogato e non ti viene addebitato alcun costo. Per alcuni paesi, questo riguarda una quota consistente degli utenti reali. Per coprire questi casi, raccogli l’identificativo anche da una risposta a un Questionario, da un campo estratto da Document AI o da un valore che invii al momento della creazione della sessione, e mappalo nel passaggio di Validazione su database.

Parametri del body

string
predefinito:"ITA"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: ITA
string
predefinito:"ita_credit_bureau"
obbligatorio
Array che contiene questo ID servizio. Fissare il servizio mantiene la richiesta limitata a questo specifico database.Esempio: ita_credit_bureau
string
predefinito:"John"
obbligatorio
Nome da validare.Esempio: John
string
predefinito:"Doe"
obbligatorio
Cognome da validare.Esempio: Doe
object
obbligatorio
Oggetto dell’indirizzo residenziale strutturato. Usa street_1, street_2, city, region, postal_code e country. Una stringa di indirizzo completa in formato legacy è ancora accettata, ma non è consigliata.Esempio: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
predefinito:"SAMPLE-TAX-12345"
obbligatorio
Numero di identificazione fiscale o codice fiscale.Esempio: SAMPLE-TAX-12345
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 i controlli autonomi allo stesso utente finale e ridurre il rumore dovuto ai duplicati.Esempio: user-1234

Regole di input e note di validazione

  • tax_number deve essere lungo esattamente 16 caratteri.
  • Per i servizi basati sull’indirizzo, quando possibile invia i campi strutturati dell’indirizzo invece di una singola stringa address.
  • address.street_1 è l’indirizzo stradale, incluso il numero civico e il tipo di via.
  • address.street_2 è l’appartamento, l’interno, l’edificio, il piano o una riga aggiuntiva dell’indirizzo. Invialo solo se lo hai.
  • address.city è la città, il sobborgo, il distretto, la località o il quartiere.
  • address.region è lo stato, la provincia, la regione o il comune.
  • address.postal_code è il codice di avviamento postale (CAP).
  • I servizi di database basati sull’indirizzo richiedono almeno indirizzo stradale e CAP; le richieste rifiutate prima della ricerca nella fonte dati non vengono addebitate.

Come effettuare la chiamata

Dati restituiti

I campi esatti esposti in source_data dipendono da ciò che restituisce il registro. L’esempio generato per ita_credit_bureau documenta attualmente questa struttura normalizzata:
  • address
  • date_of_birth
  • first_name
  • identification_number
  • last_name

Prezzi e SLA

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

Continua a leggere

Ultima modifica il 7 novembre 2026