---
title: Gestion des erreurs
canonical: https://developer.unico.io/fr/developers/sdks-and-tools/ios/error-handling
locale: fr
generated_by: markdown-export
---

- [/fr/](/fr/)
- [SDKs et outils](/fr/developers/sdks-and-tools/overview)
- [iOS SDK](/fr/developers/sdks-and-tools/ios/requirements)
- Gestion des erreurs

# Gestion des erreurs

Toute la gestion des erreurs du SDK iOS est centralisée dans cette section. Les erreurs sont transmises sous la forme d'un objet `ErrorBio` exposant les propriétés `code` (`Int`) et `desc` (`String`) : les erreurs de capture et de parcours (y compris `74001`) arrivent dans `onErrorSelfie`, tandis que les erreurs de configuration et d'initialisation arrivent dans `onErrorAcessoBioManager`.

Codes d'erreur
| Code | Description |
| --- | --- |
| `73000` | La session a été annulée en raison d'une erreur inconnue et inattendue. Le SDK Unico Check exploite de nombreuses API iOS, notamment la caméra, le stockage, la sécurité, le réseau, et bien d'autres — il s'agit d'un cas générique. |
| `73001` | Contexte invalide |
| `73003` | La version de l'API doit être 13 ou supérieure |
| `73006` | Impossible d'ouvrir la caméra sur les émulateurs |
| `73100` | Impossible de se connecter à Internet |
| `73200` | Fichier JSON unico_sdk introuvable |
| `73202` | Impossible de charger le fichier JSON unico_sdk |
| `73203` | Impossible de charger `AcessoBioConfigDataSource` |
| `73204` | Impossible d'initialiser le SDK — configurez l'environnement via `setEnvironment` lors du build |
| `73300` | Impossible d'obtenir l'objet d'authentification Unico |
| `73301` | Impossible d'analyser l'objet d'authentification Unico |
| `73302` | Token Unico introuvable |
| `73701` | Import de liveness active introuvable |
| `73702` | Impossible d'initialiser la liveness active en mode production |
| `73703` | Impossible d'obtenir la session de liveness active |
| `73704` | L'utilisateur a appuyé sur le bouton d'annulation et n'a pas complété la session |
| `73705` | La session n'a pas été effectuée avec succès et aucun FaceScan n'a été généré |
| `73706` | Accès à la caméra refusé — l'utilisateur a explicitement refusé l'autorisation ou une politique appareil la bloque |
| `73707` | La session a été annulée car l'application a été fermée, mise en veille, par une notification du système d'exploitation, ou placée en arrière-plan |
| `73708` | La session a été annulée car l'appareil est en mode paysage |
| `73709` | La session a été annulée car l'appareil est en mode portrait inversé |
| `73710` | La session a été annulée car l'utilisateur n'a pas pu la terminer dans le délai imparti |
| `73711` | La session a été annulée en raison d'une pression mémoire |
| `73712` | La session a été annulée car votre application n'est pas en production et nécessite une connexion réseau |
| `73713` | La session a été annulée car votre clé doit être validée à nouveau |
| `73714` | La session a été annulée car la clé de chiffrement configurée par le développeur n'était pas valide |
| `73715` | La session a été annulée car toutes les images de guidage n'étaient pas configurées |
| `73716` | La session a été annulée car le SDK n'a pas pu démarrer la caméra sur cet appareil |
| `73717` | La session a été annulée car l'utilisateur était dans un état bloqué |
| `73718` | Erreur inconnue et inattendue lors de l'utilisation normale des API iOS |
| `73719` | La session a été annulée car l'utilisateur a appuyé sur le sous-texte de l'écran de préparation |
| `73720` | La session n'a pas été traitée |
| `73721` | La session ne peut pas être effectuée : limite de tentatives dépassée |
| `73722` | La session ne peut pas être effectuée : délai d'alignement du visage dépassé |
| `73730` | Impossible d'initialiser une session de liveness active — erreur de licence inconnue |
| `73731` | Impossible d'initialiser une session de liveness active — licence expirée |
| `73800` | Impossible de générer la clé chiffrée |
| `74001` | Callback `onSuccess` non implémenté lors de l'ouverture de la caméra avec `webAppToken` |

Catalogue officiel des erreursLes codes ci-dessus reflètent le catalogue du SDK iOS. Le catalogue officiel des codes d'erreur multi-plateformes est disponible dans [Référence API > Codes d'erreur](/fr/developers/start/error-codes).

Callbacks du cycle de vie
En plus de `onErrorAcessoBioManager`, le SDK déclenche également :

- `onUserClosedCameraManually()` — l'utilisateur a fermé la caméra manuellement.
- `onSystemClosedCameraTimeoutSession()` — la session a expiré en raison d'un délai d'attente (valeur par défaut 40 s, minimum 40 s).
- `onSystemChangedTypeCameraTimeoutFaceInference()` — la détection du visage a dépassé le seuil de 13 s ; la capture passe en mode manuel.

Routage des callbacks pour les annulations et timeoutsLes erreurs `73704` (annulation utilisateur) et `73710` (timeout de session) ne sont **pas** transmises via `onErrorAcessoBioManager`. Elles déclenchent directement les callbacks de cycle de vie correspondants :

- `73704` → `onUserClosedCameraManually()`
- `73710` → `onSystemClosedCameraTimeoutSession()`

Dernière mise à jour le **23 oct. 2026**