Back-office

Sessions et états

Une session est une vérification d'un usager, du début à la fin. Un même serveur peut avoir des centaines de sessions simultanées : chacune a son id et son client_secret.

États

ÉtatSignification
createdSession créée, le SDK n'a pas encore été ouvert.
document_pendingConsentement donné, photos de la pièce attendues (ou à reprendre : voir document_feedback).
document_processingAnalyse de la pièce. La session est débitée à l'entrée dans cet état.
challenge_pendingPièce acceptée, vidéo du challenge attendue.
liveness_processingAnalyse de la vidéo et comparaison des visages.
verifiedIdentité vérifiée.
rejectedVérification refusée : voir les motifs.
manual_reviewDoute : le dossier est examiné par l'équipe CheckID.
expiredL'usager n'a pas terminé à temps.
canceledAnnulée par votre serveur.

Expiration

Une session expire 15 minutes après sa création si le SDK n'a jamais été ouvert, puis après 30 minutes sans action de l'usager. Seuls les états d'attente (created, document_pending, challenge_pending) expirent.

Nouvelles tentatives

Si la pièce est illisible ou le challenge mal réalisé, l'usager est invité à recommencer, 3 fois au plus pour chaque étape, sans nouvelle facturation. Au-delà, la session est rejetée.

Motifs

decision.reasons liste les motifs d'un rejet ou d'une revue manuelle :

face_mismatchLe visage de la vidéo ne correspond pas à celui de la pièce.
face_match_uncertainCorrespondance incertaine : revue manuelle.
challenge_failedLe challenge n'a pas été réalisé.
video_unreadableVidéo illisible.
document_expiredPièce expirée.
document_unreadable, fields_unreadablePièce ou champs illisibles après toutes les tentatives.
mrz_checksum_invalidChiffres de contrôle de la MRZ incorrects.
mrz_visual_mismatchLa MRZ ne correspond pas aux données imprimées.
document_number_invalid, birth_date_invalid, expiry_date_invalidFormat ou valeur impossible.
holder_too_youngTitulaire de moins de 15 ans.
internal_errorErreur de CheckID : la session est remboursée.