Erreurs

Toutes les erreurs ont la même forme :

{ "error": { "code": "unreadable", "message": "front image too blurred (sharpness 4.2)" } }

Basez votre code sur code, qui est stable. message est une aide au débogage en anglais, qui peut changer.

Codes

HTTP	`code`	Cause	Que faire
400	`invalid_request`	Paramètre manquant ou mal formé, `front` absent, image de plus de 12 Mo	Corriger la requête
413	`invalid_request`	Corps JSON trop lourd (images en base64 au-delà de la limite)	Envoyer en multipart, ou réduire les images
401	`unauthorized`	Clé absente, mal formée, inconnue ou révoquée ; jeton client invalide	Vérifier la clé
402	`insufficient_balance`	Clé live, et le portefeuille prépayé de l’organisation ne couvre pas cette vérification. Rien n’a été traité ni facturé ; une session reste utilisable	Recharger dans la console, page Portefeuille
403	`invalid_token`	Lien d’image expiré ou falsifié	Redemander une URL
403	`live_not_enabled`	Création d’une clé ou d’une session live avant l’activation du mode live	Accepter les conditions du mode live dans la console
403	`live_suspended`	Le mode live de l’organisation a été suspendu par VerifNer	Contacter VerifNer
404	`not_found`	Vérification, session ou webhook inconnu dans votre organisation	Vérifier l’identifiant
409	`session_completed`	La session a déjà produit une vérification	Ouvrir une nouvelle session
409	`session_expired`	La session a dépassé sa durée de validité	Ouvrir une nouvelle session
410	`image_gone`	Image jamais conservée (clé de test) ou supprimée après la durée de rétention
422	`unreadable`	Photo trop floue pour être lue	Demander une nouvelle photo
422	`not_an_image`	Fichier qui n’est pas une image JPEG, PNG ou WebP	Envoyer une image
422	`extraction_failed`	Le document n’a pas pu être lu	Réessayer, ou demander une meilleure photo
429	`rate_limited`	Trop de requêtes	Attendre, puis réessayer
503	`service_busy`	Trop de vérifications en même temps : la comparaison faciale ou la lecture du document ne peut pas démarrer à temps. Rien n’a été enregistré ni facturé ; une session reste utilisable	Réessayer après le délai de l’en-tête `Retry-After` (5 s)
5xx	`internal`	Incident de notre côté	Réessayer avec la même `Idempotency-Key`

Une erreur 4xx n’est pas facturée et n’enregistre aucune vérification.

Réessayer

Réessayez automatiquement les 429 et les 5xx, avec un délai croissant (1 s, 2 s, 4 s…) et la même Idempotency-Key. Pour un 503 service_busy, attendez le délai de l’en-tête Retry-After, avec un peu d’aléa pour que vos requêtes ne reviennent pas toutes ensemble. Le SDK web le fait pour vous pendant une trentaine de secondes. Ne réessayez pas les autres 4xx sans corriger la requête.

Démarrer

Vérification

Intégration

Console

Référence

Codes

Réessayer