Passer au contenu principal
POST
Vérifie les données saisies auprès du service de données officiel en Chine. Didit expose ce service via POST /v3/database-validation/ afin que vous puissiez comparer les données soumises à la source faisant autorité et recevoir des résultats de correspondance normalisés. Format de saisie : date_of_birth doit correspondre à la date de naissance encodée dans le numéro d’identité nationale chinois (chiffres 7 à 14 d’un numéro de 18 caractères, chiffres 7 à 12 d’un numéro de 15 chiffres d’ancien format) ; national_id correspond au numéro de carte d’identité de résident chinois (15 chiffres ou 18 caractères avec somme de contrôle).

Couverture

  • Couverture : ~ 100%
  • Pays : Chine
  • Identifiant du service : chn_bank_card
  • Domaine de données : Financier
  • Catégorie : Banque

Entrées

  • Entrées obligatoires : full_name, date_of_birth, national_id, bank_card_number
  • Entrées facultatives : vendor_data
  • Consentement : Requis
  • Disponibilité dans le workflow : Disponible dans un workflow avec mappage des champs
  • Couverture : ~ 100%
  • Prix : $0.67 par requête réussie
Dans un workflow, bank_card_number n’est pas imprimé sur un document d’identité, donc aucune étape ne le produit seule. Collectez-le à partir d’une réponse dans Questionnaires, d’un champ extrait par Document AI ou d’une valeur que vous envoyez lors de la création de la session, puis mappez-le sur l’étape Validation en base de données. Tant qu’il n’est pas mappé, l’éditeur de workflow affiche ce service désactivé et indique l’entrée manquante ; à l’exécution, une entrée manquante signifie que la vérification est ignorée avant toute requête, de sorte que vous n’êtes jamais facturé pour une base de données qui n’a pas pu être interrogée.

Paramètres du corps de la requête

string
défaut:"CHN"
requis
Code pays ISO 3166-1 alpha-3 de ce service de base de données.Exemple : CHN
string
défaut:"chn_bank_card"
requis
Tableau contenant l’identifiant de ce service. Le fait d’imposer ce service limite la requête à cette base de données précise.Exemple : chn_bank_card
Consentement explicite de l’utilisateur final pour ce service.Exemple : true
string
défaut:"王新伟"
requis
Nom légal complet à valider.Exemple : 王新伟
string
défaut:"1990-01-01"
requis
Date de naissance au format YYYY-MM-DD.Exemple : 1990-01-01
string
défaut:"11010519900101003X"
requis
Numéro d’identité nationale pour ce service.Exemple : 11010519900101003X
string
défaut:"4111111111111111"
requis
Numéro de carte bancaire.Exemple : 4111111111111111
string
défaut:"user-1234"
Votre référence stable pour cet utilisateur, par exemple votre identifiant interne d’utilisateur. Didit s’en sert pour relier les vérifications autonomes au même utilisateur final et réduire le bruit de détection des doublons.Exemple : user-1234

Règles de saisie et notes de validation

  • La date de naissance doit correspondre à la date de naissance encodée dans le numéro d’identité nationale chinois (chiffres 7 à 14 d’un numéro de 18 caractères, chiffres 7 à 12 d’un numéro de 15 chiffres d’ancien format)
  • date_of_birth doit correspondre à la date de naissance encodée dans national_id ; la source rejette la requête d’emblée lorsque les deux diffèrent, de sorte qu’une incohérence est refusée avant la recherche et n’est pas facturée.
  • Numéro de carte d’identité de résident chinois (15 chiffres ou 18 caractères avec somme de contrôle)
  • national_id doit correspondre à (?:\d{15}|\d{17}[\dXx]).
  • Le caractère de contrôle final de la carte d’identité de résident chinoise est validé.
  • full_name doit être le nom d’origine en caractères chinois tel qu’il figure dans le registre ou sur le document. N’envoyez pas la translittération latine pour les vérifications de bases de données chinoises.

Comment l’appeler

Données renvoyées

Les champs exacts exposés dans source_data dépendent de ce que renvoie le registre. L’exemple généré pour chn_bank_card documente actuellement cette structure normalisée :
  • date_of_birth
  • full_name
  • identification_number

Tarifs et SLA

Les requêtes China Bank Card ne sont facturées que lorsque Didit reçoit un résultat concluant de la source de validation.
  • Prix par appel : $0.67 USD.
  • Facturation : par requête réussie. Vous n’êtes pas facturé lorsque le registre est injoignable, lorsque des champs obligatoires sont manquants ou lorsque la requête est rejetée avant d’atteindre la source.
  • Latence : p95 typique < 2 s.
  • Disponibilité : 99.9% par trimestre côté Didit ; la disponibilité des sources en aval varie selon le pays et le jeu de données.

Pour aller plus loin

Dernière modification le 7 novembre 2026