Vai al contenuto principale
POST
Verifica i dati inseriti rispetto al servizio dati ufficiale in Cina. 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. Formato di input: date_of_birth accetta la data di nascita, che deve corrispondere alla data di nascita codificata nel documento d’identità nazionale cinese (cifre da 7 a 14 di un numero di 18 caratteri, cifre da 7 a 12 di un numero legacy di 15 cifre); national_id accetta il numero della carta d’identità di residente cinese (15 cifre oppure 18 caratteri con checksum).

Copertura

  • Copertura: ~ 100%
  • Paese: Cina
  • ID servizio: chn_bank_card
  • Dominio dei dati: Finanziario
  • Categoria: Bancario

Input

  • Input obbligatori: full_name, date_of_birth, national_id, bank_card_number
  • Input facoltativi: vendor_data
  • Consenso: obbligatorio
  • Disponibilità nel workflow: disponibile nel workflow con mappatura dei campi
  • Copertura: ~ 100%
  • Prezzo: $0.67 per query riuscita
In un workflow, bank_card_number non è stampato su un documento d’identità, quindi nessun passaggio lo produce da solo. Raccoglilo da una risposta di un Questionario, da un campo di estrazione di Document AI oppure da un valore che invii al momento della creazione della sessione, e mappalo nel passaggio di Validazione su database. Finché non è mappato, l’editor del workflow mostra questo servizio come disabilitato e indica l’input mancante; in fase di esecuzione, un input mancante fa sì che il controllo venga saltato prima di qualsiasi query, così non ti viene addebitato un database che non poteva essere interrogato.

Parametri del body

string
predefinito:"CHN"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: CHN
string
predefinito:"chn_bank_card"
obbligatorio
Array che contiene l’ID di questo servizio. Specificare il servizio vincola la richiesta a questo database specifico.Esempio: chn_bank_card
Consenso esplicito dell’utente finale per questo servizio.Esempio: true
string
predefinito:"王新伟"
obbligatorio
Nome legale completo da validare.Esempio: 王新伟
string
predefinito:"1990-01-01"
obbligatorio
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
predefinito:"11010519900101003X"
obbligatorio
Numero di identità nazionale per questo servizio.Esempio: 11010519900101003X
string
predefinito:"4111111111111111"
obbligatorio
Numero della carta bancaria.Esempio: 4111111111111111
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, come il tuo ID utente interno. Didit lo usa per collegare i controlli autonomi allo stesso utente finale e ridurre il rumore nel rilevamento dei duplicati.Esempio: user-1234

Regole di input e note sulla validazione

  • La data di nascita deve corrispondere alla data di nascita codificata nel documento d’identità nazionale cinese (cifre da 7 a 14 di un numero di 18 caratteri, cifre da 7 a 12 di un numero legacy di 15 cifre)
  • date_of_birth deve corrispondere alla data di nascita codificata in national_id; la fonte rifiuta la richiesta immediatamente quando i due valori non coincidono, quindi una mancata corrispondenza viene respinta prima della ricerca e non viene addebitata.
  • Numero della carta d’identità di residente cinese (15 cifre oppure 18 caratteri con checksum)
  • national_id deve corrispondere a (?:\d{15}|\d{17}[\dXx]).
  • Viene validato il carattere di controllo finale della Carta d’identità di residente cinese.
  • full_name deve essere il nome originale in caratteri cinesi così come appare nel registro o sul documento. Non inviare la traslitterazione latina per i controlli sui database cinesi.

Come effettuare la chiamata

Dati restituiti

I campi esatti che compaiono in source_data dipendono da ciò che restituisce il registro. L’esempio generato per chn_bank_card documenta attualmente questa struttura normalizzata:
  • date_of_birth
  • full_name
  • identification_number

Prezzi e SLA

Le query China Bank Card vengono fatturate solo quando Didit riceve un risultato definitivo dalla fonte di validazione.
  • Prezzo per chiamata: $0.67 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 lato Didit; la disponibilità delle fonti a valle varia in base al paese e al dataset.

Continua la lettura

Ultima modifica il 7 novembre 2026