Dossiers et décisions

Un dossier (case) est une vérification : une personne, un parcours, une décision. Il porte votre référence (external_ref), le parcours suivi (flow_name) et le pays (country).

Les états

État	Ce qui se passe
created	Le dossier existe ; la personne n’a pas encore commencé.
collecting	La personne est sur le parcours : pièces et selfie en cours d’envoi.
processing	Tout est reçu (case.submitted) ; les contrôles tournent.
review	Un opérateur examine le dossier dans la console. Les constats qui l’y ont envoyé (bande illisible, visage peu ressemblant, titre expiré…) lui sont affichés.
decided	La décision est rendue. État final.
abandoned	La personne a abandonné. État final.
expired	Le dossier a dépassé son échéance (expires_at). État final.

Les décisions

L’événement case.decided porte la décision (outcome) et un code de motif (reason_code) :

outcome	Signification
approved	L’identité est vérifiée.
rejected	L’identité n’est pas vérifiée. Le motif dit pourquoi.
manual_review	Le cas demande un regard humain : il part en revue, et une décision suivra.
expired	Le dossier a expiré avant d’être complet.
abandoned	La personne n’est pas allée au bout.

Une décision peut être révisée par un superviseur. Vous recevez alors case.decision_revised, qui porte la nouvelle décision et l’ancienne (previous_outcome). Si vous avez agi sur la première décision, c’est le signal pour revenir dessus.

Ce que vous ne recevez pas

L’API ne renvoie ni les images ni les données extraites de la pièce dans les webhooks : ce ne sont que des identifiants et des décisions. Le détail du dossier et sa preuve se consultent dans la console, où chaque consultation est tracée.