Types de documents renvoyés par le lecteur
documents[].doc_type est l’un de ces codes, ou une autre chaîne en minuscules, ou null.
Chaque document reçoit aussi les contrôles qui ne dépendent pas de son type : le filtre
doctype: quand une étape ou une indication filtre (voir plus bas), expiry: quand un id_expiry a été lu, un contrôle MRZ quand des lignes MRZ ont été lues, les contrôles de fichier provenance: et le contrôle authenticity:specimen:. Le guide de vérification explique chacun.
Le lecteur a pour consigne de répondre other en cas de doute, car une étiquette fausse donnée avec assurance fait refuser le document d’un client. Les documents juridiques libres (le dernier groupe) sont acceptés avec other par les étapes qui les attendent. Le texte libre du lecteur est ramené à ces codes par radical, donc “Driver License”, “PR Card” et “Void Cheque” arrivent sous les formes drivers_license, pr_card et void_cheque.
Deux documents d’adresse sont acceptés comme justificatif de domicile : utility_bill et bank_statement. Un chèque n’en est jamais un.
Clés de champs
Toutes les clés que le lecteur peut renvoyer, par groupe. Une clé absente de cette liste est écartée.id_type est l’une de ces valeurs : Passport, Driver License, National ID, Residence Permit (une carte de résident permanent et une green card sont Residence Permit).
Le lecteur sait quel côté d’un document est celui du client. Sur une facture, une note ou un relevé, le client est le destinataire (la partie “facturée à”), jamais l’émetteur. document_holder_name, legal_name, l’adresse et les clés de contact décrivent le destinataire.
Champs par type de document
Ce que le lecteur doit chercher sur chaque type, et ce dont les contrôles ont besoin. Le lecteur ne renvoie que ce qui est imprimé et lisible. Rien ci-dessous n’est garanti.
Si tous les champs attendus d’un type manquent,
legible: est critical. Si certains seulement manquent, c’est un warning qui les nomme (could not read: id_number).
Les montants ne sont lus que dans un document qui les indique. Un bulletin de paie montre la paie d’une période. Le lecteur a pour consigne de ne jamais estimer, donc
annual_income est absent sauf s’il est imprimé. Ne vous fiez pas à un bulletin de paie seul pour le revenu annuel. Voir le parcours pas à pas.Quels champs arrivent dans fields
Filtrage : step_key et doc_type
step_key fait vérifier par l’appel que le document est de ceux que l’étape attend. Le contrôle doctype: est critical : si le lecteur dit “facture de services” et que l’étape prend une pièce d’identité avec photo, la réponse dit this is a utility bill; this step takes a passport, a national ID card, a driver's licence... et l’entrée échoue.
Si vous n’envoyez pas de step_key, le texte de doc_type sert aussi de filtre quand il contient l’une de ces expressions (en minuscules, les espaces comptent) : photo id, passport, pr card, proof of address, bank, articles of incorporation, business registration. Par exemple doc_type=passport accepte un passeport, une carte d’identité nationale, un permis de conduire ou un titre de séjour. doc_type=bank_statement contient bank et accepte un relevé bancaire, une facture de services ou un chèque annulé. doc_type=payslip ne correspond à rien et n’est pas filtré. Utilisez step_key quand vous voulez un filtre précis.
Une étape connue sans filtre de type (banking, rib et quelques autres) accepte n’importe quel document.
Clés d’étape
Une étape marquée
address est une étape de justificatif de domicile. Une utility_bill, un proof_of_address ou un bank_statement lu à cet endroit subit un contrôle de récence bloquant (critical, 90 jours par défaut). Sur toute autre étape, le même contrôle est un warning.