Documentation suite web identité
Qu’est ce que la suite web identité ?
Vous trouverez un descriptif général exhaustif sur la page produit suite web identité.
Liste des documents d’identité supportés
Passeports
Les pays suivants sont supportés :
- tous les pays
Cartes d’identité
Les pays suivants sont supportés :
- France
- Roumanie
Titres de séjour / cartes de séjour
Les pays suivants sont supportés :
- France
Passport card / Border crossing card
Les pays suivants sont supportés :
- Etats-Unis
Cartes d’identité biométriques
Les pays suivants sont supportés :
- France (FRA)
- Allemagne (DEU)
- Espagne (ESP)
- Luxembourg (LUX)
- Hollande (NLD)
- Autriche (AUT)
- Pologne (POL)
- Belgique (BEL)
- Portugal (PRT)
- Lituanie (LTU)
- Bulgarie (BGR)
- Roumanie (ROU)
- Estonie (EST)
- Lettonie (LVA)
- Chypre (CYP)
- Malte (MLT)
- Tchéquie (CZE)
- Slovaquie (SVK)
- Finlande (FIN)
- Suède (SWE)
- Grèce (GRC)
- Suisse (CHE)
- Croatie (HRV)
- Hongrie (HUN)
- Norvège (NOR)
Permis de conduire biométriques
Les pays suivants sont supportés :
- France (FRA)
- Algérie (DZA)
- Estonie (EST)
- Croatie (HRV)
Comment envoyer les documents ?
Formats acceptés
Les formats acceptés sont :
– PDF
– images (png / jpg / webp etc)
Nombre de fichiers par appel
L’API n’accepte qu’un fichier par appel avec le paramètre « file » : il n’est donc pas possible d’ajouter le recto sur un fichier et verso sur une deuxième fichier.
Comment éviter les problèmes de reconnaissance des documents ?
Nous avons réalisé une documentation spécifique détaillant les différents points de vigilance pour éviter les problèmes de reconnaissance des documents.
Interface web
Element central de la suite, l’interface web vous permet de :
– Voir les détails de votre abonnement
– Savoir combien il vous reste de vérifications sur chaque abonnement
– Accéder à l’historique de vos analyses
– Télécharger les rapports JSON et XML de chaque analyse
– Supprimer les données
Langues disponibles
L’interface web est disponibles dans les langues suivantes :
– Français
– Anglais
Onglet abonnements
Vous trouverez la liste de vos abonnements sur la page d’acccueil de l’interface web, avec les informations suivantes :
– Type de plan (PRO, BUSINESS, CORPORATE ou SINGLE_PAYMENT)
– Périodicité (mensuelle ou annuelle, non disponible pour les SINGLE_PAYMENT)
– Souscription active : est-ce que votre abonnement est actif ou non
– Date de renouvellement / fin d’abonnement
– Vérifications restantes : nombre de vérifications restantes sur votre abonnement, sur la période
Onglet identité
L’onglet identité (accessible si un abonnement Identité est actif) vous permet d’accéder à différentes informations et outils.
Historique
L’historique des analyses vous permet de connaitre l’historique complet des analyses réalisées, avec les informations suivantes :
- date de l’analyse
- type de document vérifié
- téléchargement du rapport aux formats PDF / JSON / XML
- suppression des données correspondantes
Outil "Vérifier un document"
L’outil « Vérifier un document » vous permet d’envoyez directement les documents à vérifier depuis l’interface web.
Les résultats seront ensuite disponibles dans l’historique, avec téléchargement possible sous forme de rapport PDF, JSON ou XML.
Outil "caractères MRZ"
L’outil « caractères MRZ » vous permet de vérifier la validité d’un document d’identité en saisissant les caractères de la bande MRZ (ou copier / coller).
Les résultats sont ensuite disponibles au téléchargement dans l’historique, aux formats PDF / JSON / XML.
L’avantage est qu’il n’est pas nécessaire d’envoyer le document « réel », et peut donc représenter un avantage dans certaines situations.
Outil "numéro de sécurité sociale"
L’outil « numéro de sécurité sociale » vous permet d’extraire les informations contenues dans les numéros de sécurité sociale et de vérifier la validité de la clé de sécurité.
Les données ne sont pas sauvegardées et ne sont donc pas disponibles au téléchargement sous forme de rapport.
Erreurs possibles
Document non reconnu
Cette erreur vous indique que le document n’a pas pu être reconnu.
Vérifiez les points suivants :
- Le format correspond au format indiqué dans la documentation
- Le document correspond à l’un des documents compatibles avec le service
- Le document est lisible
Plus de crédits disponibles
Cette erreur vous indique que vous n’avez plus de crédits disponible.
Il convient alors de souscrire un nouvel abonnement, ou dacheter de nouvelles vérifications via les single payments.
Vérifications effectuées sur chaque type de document
Vous trouverez ci dessous la liste ainsi que le descriptif des différents champs et vérifications effectuées sur chacun des type de documents d’identité compatible avec nos produits.
Passeports
| Nom du paramètre | Type | Description |
| numberOfCharacters | String | Nombre de caractères extraits de la bande MRZ |
| documentType | String | Type de document |
| country | String | Pays |
| lastName | String | Nom du titulaire |
| firstNames | Array | Prénoms du titulaire |
| dateOfBirth | String | Date de naissance du titulaire |
| gender | String | Genre du titulaire |
| documentNumber | String | Numéro du document (selon les pays) |
| nationality | String | Nationalité du titulaire |
| personalNumber | String | Numéro personnel du titulaire |
| expirationDate | String | Date de fin de validité du document |
| numberOfCharactersValid | Boolean | Est-ce que le nombre de caractères détectés est valide ? (88) |
| documentTypeValid | Boolean | Est-ce que le type du document détecté est valide ? (« P » pour un passeport) |
| lastNameValid | Boolean | Est-ce que le nom comprend des caractères non autorisés ou des chiffres ? |
| dateOfBirthValid | Boolean | Est-ce que le format de la date de naissance extraite est valide ? |
| genderValid | Boolean | Est-ce que le caractère faisant référence au genre est valide ? |
| expirationDateValid | Boolean | Est-ce que le format de la date d’expiration extraite est valide ? |
| expirationDateControlKey | Boolean | Est-ce que la clé de contrôle de la date de fin de validité est valide ? |
| personalNumberControlKey | Boolean | Est-ce que la clé du numéro personnel est valide ? |
| dateOfBirthControlKey | Boolean | Est-ce que la clé de la date de naissance est valide ? |
| line2ControlKey | Boolean | Est-ce que la clé de contrôle de la ligne 2 est valide ? |
| globalControlKey | Boolean | Est-ce que la clé de contrôle globale est valide ? |
Carte d'identité française
| Nom du paramètre | Type | Description |
| numberOfCharacters | String | Nombre de caractères extraits de la bande MRZ |
| documentType | String | Type de document |
| country | String | Pays |
| lastName | String | Nom du titulaire |
| firstNames | Array | Prénoms du titulaire |
| dateOfBirth | String | Date de naissance du titulaire |
| gender | String | Genre du titulaire |
| department | String | Numéro du département |
| documentCreationDate | String | Date de création du document |
| expirationDate | String | Date de fin de validité du document |
| numberOfCharactersValid | Boolean | Est-ce que le nombre de caractères détectés est valide ? (72) |
| documentTypeValid | Boolean | Est-ce que le type du document détecté est valide ? |
| countryValid | Boolean | Est-ce que le code pays est valide (« FRA ») ? |
| lastNameValid | Boolean | Est-ce que le nom comprend des caractères non autorisés ou des chiffres ? |
| dateOfBirthValid | Boolean | Est-ce que le format de la date de naissance extraite est valide ? |
| genderValid | Boolean | Est-ce que le caractère faisant référence au genre est valide ? |
| departmentValid | Boolean | Est-ce que le format du numéro de département extrait est valide ? |
|
departmentFormatFirstLineValid
|
Boolean | Est-ce que le numéro de département respecte le formalisme lié à la date de création du document ? |
| documentCreationDateValid | Boolean | Est-ce que le format de la date de création du document extraite est valide ? |
| departmentConsistency | Boolean | Est-ce que le numéro du département de la ligne 1 correspond à celui de la ligne 2 ? |
| dateOfBirthControlKey | Boolean | Est-ce que la clé de la date de naissance est valide ? |
| line2ControlKey | Boolean | Est-ce que la clé de contrôle de la ligne 2 est valide ? |
| globalControlKey | Boolean | Est-ce que la clé de contrôle globale est valide ? |
Carte d'identité roumaine
| Nom du paramètre | Type | Description |
| numberOfCharacters | String | Nombre de caractères extraits de la bande MRZ |
| documentType | String | Type de document |
| country | String | Pays |
| lastName | String | Nom du titulaire |
| firstNames | Array | Prénoms du titulaire |
| dateOfBirth | String | Date de naissance du titulaire |
| gender | String | Genre du titulaire |
| documentNumber | String | Numéro du document (selon les pays) |
| nationality | String | Nationalité du titulaire |
| personalNumber | String | Numéro personnel du titulaire |
| expirationDate | String | Date de fin de validité du document |
| numberOfCharactersValid | Boolean | Est-ce que le nombre de caractères détectés est valide ? (88) |
| documentTypeValid | Boolean | Est-ce que le type du document détecté est valide ? (« P » pour un passeport) |
| countryValid | Boolean | Est-ce que le code pays extrait est valide ? |
| lastNameValid | Boolean | Est-ce que le nom comprend des caractères non autorisés ou des chiffres ? |
| nationalityValid | Boolean | Est-ce que le code nationalité est valide ? |
| dateOfBirthValid | Boolean | Est-ce que le format de la date de naissance extraite est valide ? |
| genderValid | Boolean | Est-ce que le caractère faisant référence au genre est valide ? |
| expirationDateValid | Boolean | Est-ce que le format de la date d’expiration extraite est valide ? |
| expirationDateControlKey | Boolean | Est-ce que la clé de contrôle de la date de fin de validité est valide ? |
| dateOfBirthControlKey | Boolean | Est-ce que la clé de la date de naissance est valide ? |
| line2ControlKey | Boolean | Est-ce que la clé de contrôle de la ligne 2 est valide ? |
| globalControlKey | Boolean | Est-ce que la clé de contrôle globale est valide ? |
Cartes d'identité biométriques
| Nom du paramètre | Type | Description |
| numberOfCharacters | String | Nombre de caractères extraits de la bande MRZ |
| documentType | String | Type de document |
| country | String | Pays |
| lastName | String | Nom du titulaire |
| firstNames | Array | Prénoms du titulaire |
| dateOfBirth | String | Date de naissance du titulaire |
| gender | String | Genre du titulaire |
| documentNumber | String | Numéro du document |
| personalNumber | String | Numéro personnel (présent sur certaines cartes uniquement) |
| nationality | String | Nationalité du titulaire |
| expirationDate | String | Date de fin de validité du document |
| numberOfCharactersValid | Boolean | Est-ce que le nombre de caractères détectés est valide |
| documentTypeValid | Boolean | Est-ce que le type du document détecté est valide ? |
| lastNameValid | Boolean | Est-ce que le nom comprend des caractères non autorisés ou des chiffres ? |
| dateOfBirthValid | Boolean | Est-ce que le format de la date de naissance extraite est valide ? |
| genderValid | Boolean | Est-ce que le caractère faisant référence au genre est valide ? |
| countryValid | Boolean | Est-ce que le format du pays extrait est valide (« FRA ») ? |
| documentNumberValid | Boolean | Est-ce que le format du numéro de document extrait est valide (9 caractères) ? |
| nationalityValid | Boolean | Est-ce que le format de la nationalité est valide (« FRA ») ? |
| expirationDateControlKey | Boolean | Est-ce que la clé de contrôle de la date de fin de validité est valide ? |
| documentNumberControlKey | Boolean | Est-ce que la clé de contrôle du numéro du document est valide ? |
| dateOfBirthControlKey | Boolean | Est-ce que la clé de la date de naissance est valide ? |
| globalControlKey | Boolean | Est-ce que la clé de contrôle globale est valide ? |
Permis de conduire biométrique français
| Nom du paramètre | Type | Description |
| numberOfCharacters | String | Nombre de caractères extraits de la bande MRZ |
| documentType | String | Type de document |
| country | String | Pays |
| lastName | String | Nom du titulaire |
| documentNumber | String | Numéro du document |
| expirationDate | String | Date de fin de validité du document |
| numberOfCharactersValid | Boolean | Est-ce que le nombre de caractères détectés est valide |
| documentTypeValid | Boolean | Est-ce que le type du document détecté est valide ? |
| lastNameValid | Boolean | Est-ce que le nom comprend des caractères non autorisés ou des chiffres ? |
| countryValid | Boolean | Est-ce que le format du pays extrait est valide (« FRA ») ? |
| documentNumberValid | Boolean | Est-ce que le format du numéro de document extrait est valide (9 caractères) ? |
| documentNumberControlKey | Boolean | Est-ce que la clé de contrôle du numéro du document est valide ? |
| globalControlKey | Boolean | Est-ce que la clé de contrôle globale est valide ? |
Permis de conduire biométrique estonien
| Nom du paramètre | Type | Description |
| numberOfCharacters | String | Nombre de caractères extraits de la bande MRZ |
| documentType | String | Type de document |
| country | String | Code pays |
| documentNumber | String | Numéro du document |
| personalNumber | String | Numéro personnel du titulaire |
| numberOfCharactersValid | Boolean | Est-ce que le nombre de caractères détectés est valide |
| documentTypeValid | Boolean | Est-ce que le type du document détecté est valide ? |
| countryValid | Boolean | Est-ce que le code pays est correct ? |
| documentNumberValid | Boolean | Est-ce que le format du numéro de document extrait est valide ? |
| personalNumberValid | Boolean | Est-ce que le format du numéro de document extrait est valide ? |
| globalControlKey | Boolean | Est-ce que la clé de contrôle globale est valide ? |
Permis de conduire biométrique croate
| Nom du paramètre | Type | Description |
| numberOfCharacters | String | Nombre de caractères extraits de la bande MRZ |
| documentType | String | Type de document |
| documentNumber | String | Numéro du document |
| personalNumber | String | Numéro personnel du titulaire |
| expirationDate | String | Date de fin de validité |
| numberOfCharactersValid | Boolean | Est-ce que le nombre de caractères détectés est valide |
| documentTypeValid | Boolean | Est-ce que le type du document détecté est valide ? |
| documentNumberValid | Boolean | Est-ce que le format du numéro de document extrait est valide ? |
| personalNumberValid | Boolean | Est-ce que le format du numéro de document extrait est valide ? |
| expirationDateValid | Boolean | Est-ce que le format de la date de fin de validité est correct ? |
| globalControlKey | Boolean | Est-ce que la clé de contrôle globale est valide ? |
Titre de séjour français
| Nom du paramètre | Type | Description |
| numberOfCharacters | String | Nombre de caractères extraits de la bande MRZ |
| documentType | String | Type de document |
| country | String | Pays |
| lastName | String | Nom du titulaire |
| firstNames | Array | Prénoms du titulaire |
| dateOfBirth | String | Date de naissance du titulaire |
| gender | String | Genre du titulaire |
| documentNumber | String | Numéro du document |
| personalNumber | String | Numéro personnel du titulaire |
| nationality | String | Nationalité du titulaire |
| expirationDate | String | Date de fin de validité du document |
| numberOfCharactersValid | Boolean | Est-ce que le nombre de caractères détectés est valide |
| documentTypeValid | Boolean | Est-ce que le type du document détecté est valide ? |
| countryValid | Boolean | Est-ce que le format du pays extrait est valide ? |
| lastNameValid | Boolean | Est-ce que le nom comprend des caractères non autorisés ou des chiffres ? |
| dateOfBirthValid | Boolean | Est-ce que le format de la date de naissance extraite est valide ? |
| genderValid | Boolean | Est-ce que le caractère faisant référence au genre est valide ? |
| documentNumberValid | Boolean | Est-ce que le format du numéro de document extrait est valide (9 caractères) ? |
| personalNumberValid | Boolean | Est-ce que le format du numéro personnel extrait est valide (10 caractères) ? |
| nationalityValid | Boolean | Est-ce que le format de la nationalité est valide (« FRA ») ? |
| expirationDateValid | Boolean | Est-ce que le format de la date de fin de validité extraite est valide ? |
| expirationDateControlKey | Boolean | Est-ce que la clé de contrôle de la date de fin de validité est valide ? |
| documentNumberControlKey | Boolean | Est-ce que la clé de contrôle du numéro du document est valide ? |
| dateOfBirthControlKey | Boolean | Est-ce que la clé de la date de naissance est valide ? |
| globalControlKey | Boolean | Est-ce que la clé de contrôle globale est valide ? |
US passport card
| Nom du paramètre | Type | Description |
| numberOfCharacters | String | Nombre de caractères extraits de la bande MRZ |
| documentType | String | Type de document |
| country | String | Pays |
| lastName | String | Nom du titulaire |
| firstNames | Array | Prénoms du titulaire |
| dateOfBirth | String | Date de naissance du titulaire |
| gender | String | Genre du titulaire |
| documentNumber | String | Numéro du document |
| nationality | String | Nationalité du titulaire (« USA ») |
| expirationDate | String | Date de fin de validité du document |
| stateDepDocControlNumber | String | State department document control number |
| numberOfCharactersValid | Boolean | Est-ce que le nombre de caractères détectés est valide ? (90) |
| documentTypeValid | Boolean | Est-ce que le type du document détecté est valide ? |
| countryValid | Boolean | Est-ce que le format du pays extrait est valide (« USA ») ? |
| lastNameValid | Boolean | Est-ce que le nom comprend des caractères non autorisés ou des chiffres ? |
| dateOfBirthValid | Boolean | Est-ce que le format de la date de naissance extraite est valide ? |
| genderValid | Boolean | Est-ce que le caractère faisant référence au genre est valide ? |
| documentNumberValid | Boolean | Est-ce que le format du numéro de document extrait est valide ? |
| nationalityValid | Boolean | Est-ce que le format de la nationalité est valide ? |
| expirationDateValid | Boolean | Est-ce que le format de la date de fin de validité extraite est valide ? |
| expirationDateControlKey | Boolean | Est-ce que la clé de contrôle de la date de fin de validité est valide ? |
| documentNumberControlKey | Boolean | Est-ce que la clé de contrôle du numéro du document est valide ? |
| dateOfBirthControlKey | Boolean | Est-ce que la clé de la date de naissance est valide ? |
| globalControlKey | Boolean | Est-ce que la clé de contrôle globale est valide ? |
US border crossing card
| Nom du paramètre | Type | Description |
| numberOfCharacters | String | Nombre de caractères extraits de la bande MRZ |
| documentType | String | Type de document |
| country | String | Pays |
| lastName | String | Nom du titulaire |
| firstNames | Array | Prénoms du titulaire |
| dateOfBirth | String | Date de naissance du titulaire |
| gender | String | Genre du titulaire |
| documentNumber | String | Numéro du document |
| visaNumber | String | Numéro du visa |
| nationality | String | Nationalité du titulaire |
| expirationDate | String | Date de fin de validité du document |
| numberOfCharactersValid | Boolean | Est-ce que le nombre de caractères détectés est valide ? (90) |
| documentTypeValid | Boolean | Est-ce que le type du document détecté est valide ? (9 caractères) |
| countryValid | Boolean | Est-ce que le format du pays extrait est valide ? |
| lastNameValid | Boolean | Est-ce que le nom comprend des caractères non autorisés ou des chiffres ? |
| dateOfBirthValid | Boolean | Est-ce que le format de la date de naissance extraite est valide ? |
| genderValid | Boolean | Est-ce que le caractère faisant référence au genre est valide ? |
| documentNumberValid | Boolean | Est-ce que le format du numéro de document extrait est valide ? |
| nationalityValid | Boolean | Est-ce que le format de la nationalité est valide ? |
| expirationDateValid | Boolean | Est-ce que le format de la date de fin de validité extraite est valide ? |
| expirationDateControlKey | Boolean | Est-ce que la clé de contrôle de la date de fin de validité est valide ? |
| documentNumberControlKey | Boolean | Est-ce que la clé de contrôle du numéro du document est valide ? |
| dateOfBirthControlKey | Boolean | Est-ce que la clé de la date de naissance est valide ? |
| globalControlKey | Boolean | Est-ce que la clé de contrôle globale est valide ? |
Permis de conduire biométrique algérien
| Nom du paramètre | Type | Description |
| numberOfCharacters | String | Nombre de caractères extraits de la bande MRZ |
| documentType | String | Type de document |
| country | String | Pays |
| lastName | String | Nom du titulaire |
| firstNames | Array | Prénoms du titulaire |
| dateOfBirth | String | Date de naissance du titulaire |
| gender | String | Genre du titulaire |
| documentNumber | String | Numéro du document |
| nationality | String | Nationalité du titulaire (« FRA ») |
| expirationDate | String | Date de fin de validité du document |
| numberOfCharactersValid | Boolean | Est-ce que le nombre de caractères détectés est valide |
| documentTypeValid | Boolean | Est-ce que le type du document détecté est valide ? |
| lastNameValid | Boolean | Est-ce que le nom comprend des caractères non autorisés ou des chiffres ? |
| dateOfBirthValid | Boolean | Est-ce que le format de la date de naissance extraite est valide ? |
| genderValid | Boolean | Est-ce que le caractère faisant référence au genre est valide ? |
| countryValid | Boolean | Est-ce que le format du pays extrait est valide (« FRA ») ? |
| documentNumberValid | Boolean | Est-ce que le format du numéro de document extrait est valide (9 caractères) ? |
| nationalityValid | Boolean | Est-ce que le format de la nationalité est valide (« FRA ») ? |
| expirationDateControlKey | Boolean | Est-ce que la clé de contrôle de la date de fin de validité est valide ? |
| documentNumberControlKey | Boolean | Est-ce que la clé de contrôle du numéro du document est valide ? |
| dateOfBirthControlKey | Boolean | Est-ce que la clé de la date de naissance est valide ? |
| globalControlKey | Boolean | Est-ce que la clé de contrôle globale est valide ? |