> ## Documentation Index
> Fetch the complete documentation index at: https://verifner.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Documents pris en charge

> Les pièces d'identité lues par VerifNer, et comment bien les photographier.

## Documents

<AccordionGroup>
  <Accordion title="Passeport du Niger" icon="passport">
    Envoyez uniquement la **page d'identité** (celle avec la photo) dans `front`. Pas de `back`.

    La MRZ fait 2 lignes de 44 caractères en bas de la page (format TD3).
  </Accordion>

  <Accordion title="Carte nationale d'identité AES du Niger" icon="id-card">
    La carte biométrique de l'Alliance des États du Sahel, dans sa version délivrée par le Niger. Envoyez le **recto** dans `front` et le **verso** dans `back`.

    * Le recto porte le portrait, le nom, les prénoms, la date et le lieu de naissance, et le numéro de la carte.
    * Le verso porte les dates de délivrance et d'expiration, l'adresse, l'autorité, un QR code et la MRZ de 3 lignes de 30 caractères (format TD1).
    * Le numéro de la carte fait souvent 17 chiffres, plus que les 9 places prévues par la MRZ : il continue dans le champ suivant, comme le prévoit la norme OACI 9303. VerifNer le lit en entier.

    Le pays émetteur est renvoyé en code OACI à trois lettres : `NER` pour le Niger.
  </Accordion>

  <Accordion title="Carte nationale d'identité papier du Niger" icon="address-card">
    La carte papier, souvent plastifiée, encore délivrée et très répandue : une seule page, plus haute que large, avec le portrait en haut à droite, le timbre fiscal, l'empreinte et le cachet du commissariat. Envoyez **toute la page ouverte** dans `front`, sans `back`. Dans le SDK web, choisissez « Ancienne carte d'identité ».

    * Elle n'a **pas de MRZ**. Elle est **vérifiée automatiquement** quand tout le reste est solide : visage nettement concordant (similarité d'au moins 0,50, en pratique autour de 0,57 pour atteindre 0,90), carte non expirée, aucun signe d'altération, lecture nette avec nom, prénoms, date de naissance et numéro. Sinon, elle part en **revue humaine**.
    * Elle n'imprime **pas de date d'expiration**, seulement « Fait le ». VerifNer la considère valide **5 ans après la date de délivrance**, et expirée au-delà.
    * Le numéro est le « N° » à droite, par exemple `1234/567/21`.
    * Les cachets, le timbre fiscal, l'empreinte, l'écriture manuscrite et l'usure sont normaux et ne comptent pas comme des signes d'altération.
  </Accordion>

  <Accordion title="Carte d'identité plastique (ancien modèle)" icon="id-card-clip">
    Recto dans `front`, verso dans `back`. Quand la carte a une MRZ, elle est au verso sur 3 lignes. Sans MRZ, le score est plafonné à 0,85.
  </Accordion>
</AccordionGroup>

`document_type` vaut `passport` ou `cni` (les deux modèles de carte), ou `unknown` quand le document n'a pas été reconnu.

## Formats d'image

| | |
| - | - |
| Formats | JPEG, PNG, WebP |
| Taille maximale | 12 Mo par image |
| Résolution conseillée | 1 600 px sur le grand côté, ou plus |

Les images sont normalisées à la réception (orientation, taille). Une image trop floue est refusée avant toute lecture, avec l'erreur `422 unreadable` : demandez une nouvelle photo.

## Bien photographier un document

<CardGroup cols={2}>
  <Card title="Tout le document, rien que lui" icon="crop">
    Les quatre coins visibles, le document remplit le cadre. Pour un passeport, seulement la page d'identité.
  </Card>

  <Card title="À plat, sans reflet" icon="sun">
    Posez le document sur une surface sombre et mate. Inclinez-le légèrement si l'hologramme brille.
  </Card>

  <Card title="Net" icon="eye">
    Téléphone immobile, mise au point faite. La MRZ doit être lisible à l'œil.
  </Card>

  <Card title="L'original" icon="ban">
    Pas de photocopie, pas de photo d'écran : ce sont des signes d'altération.
  </Card>
</CardGroup>

Le [SDK web](/guides/web-sdk) applique ces règles automatiquement : il mesure la netteté, les reflets et la luminosité en direct, et recadre la photo sur le cadre affiché.