Saltar al contingut principal
POST
Verifica les dades d’entrada amb el servei oficial de dades de la Xina. Didit exposa aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font autoritativa i rebre resultats de coincidència normalitzats. Format d’entrada: date_of_birth admet la data de naixement, que ha de coincidir amb la data de naixement codificada al número d’identitat nacional xinès (dígits 7-14 d’un número de 18 caràcters, 7-12 d’un número antic de 15 dígits); national_id admet el número de la targeta d’identitat de residència xinesa (15 dígits o 18 caràcters amb dígit de control).

Cobertura

  • Cobertura: ~ 100%
  • País: Xina
  • ID del servei: chn_bank_card
  • Àmbit de dades: Financer
  • Categoria: Banca

Entrades

  • Entrades obligatòries: full_name, date_of_birth, national_id, bank_card_number
  • Entrades opcionals: vendor_data
  • Consentiment: Obligatori
  • Disponibilitat al flux de treball: Disponible al flux de treball amb mapatge de camps
  • Cobertura: ~ 100%
  • Preu: $0.67 per consulta satisfactòria
En un flux de treball, bank_card_number no s’imprimeix en cap document d’identitat, de manera que cap pas no el produeix per si sol. Recull-lo d’una resposta de qüestionari, d’un camp d’extracció de Document AI o d’un valor que enviïs en crear la sessió, i assigna’l al pas de Validació en bases de dades. Mentre no estigui assignat, l’editor de flux de treball mostra aquest servei desactivat i indica l’entrada que falta; en execució, una entrada que falta vol dir que la comprovació s’omet abans de qualsevol consulta, de manera que mai no se’t cobra per una base de dades que no s’ha pogut consultar.

Paràmetres del cos

string
predeterminat:"CHN"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.Exemple: CHN
string
predeterminat:"chn_bank_card"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: chn_bank_card
Consentiment explícit de l’usuari final per a aquest servei.Exemple: true
string
predeterminat:"王新伟"
requerit
Nom legal complet que cal validar.Exemple: 王新伟
string
predeterminat:"1990-01-01"
requerit
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
string
predeterminat:"11010519900101003X"
requerit
Número d’identitat nacional per a aquest servei.Exemple: 11010519900101003X
string
predeterminat:"4111111111111111"
requerit
Número de la targeta bancària.Exemple: 4111111111111111
string
predeterminat:"user-1234"
La teva referència estable d’aquesta persona, com ara el teu ID d’usuari intern. Didit l’utilitza per enllaçar les comprovacions independents amb el mateix usuari final i reduir el soroll de detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • La data de naixement ha de coincidir amb la data de naixement codificada a la targeta d’identitat de residència xinesa (dígits 7-14 d’un número de 18 caràcters, 7-12 d’un número antic de 15 dígits)
  • date_of_birth ha de coincidir amb la data de naixement codificada a national_id; la font rebutja la sol·licitud directament quan les dues no coincideixen, de manera que una discrepància es refusa abans de la consulta i no es cobra.
  • Número de la targeta d’identitat de residència xinesa (15 dígits o 18 caràcters amb dígit de control)
  • national_id ha de coincidir amb (?:\d{15}|\d{17}[\dXx]).
  • Es valida el caràcter de control final de la targeta d’identitat de residència xinesa.
  • full_name ha de ser el nom original en el sistema d’escriptura xinès tal com apareix al registre o al document. No enviïs la transliteració llatina per a les comprovacions de bases de dades de la Xina.

Com fer la crida

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a chn_bank_card documenta actualment aquesta forma normalitzada:
  • date_of_birth
  • full_name
  • identification_number

Preus i SLAs

Les consultes de China Bank Card només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $0.67 USD.
  • Facturació: per consulta satisfactòria. No es cobra quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
  • Latència: p95 típic < 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font final varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026