Vérification KYC
ColisMove utilise Didit V2 pour la vérification d’identité KYC (Know Your Customer). Les utilisateurs doivent finaliser le KYC pour débloquer les fonctionnalités transporteur (création d’annonces).
Vue d’ensemble du flux
Étape 1 : Initialiser la vérification
Réponse :
{
"sessionUrl": "https://verify.didit.me/session/abc123",
"status": "PENDING"
}
sessionUrl pour finaliser la vérification.
Étape 2 : L’utilisateur finalise la vérification
L’utilisateur est redirigé vers l’interface de vérification Didit où il doit :
- Scanner son document d’identité (passeport ou carte nationale)
- Prendre un selfie pour la reconnaissance faciale
- Attendre la vérification automatisée
Étape 3 : Vérifier le statut
Réponse :
{
"status": "APPROVED",
"verifiedAt": "2026-04-13T14:30:00Z"
}
Statuts KYC
| Statut | Description | Effet |
|---|
NOT_STARTED | L’utilisateur n’a jamais initié de KYC | Ne peut pas créer d’annonces |
PENDING | Vérification en cours | Ne peut pas créer d’annonces |
APPROVED | Identité vérifiée | Rôle promu à VERIFIED_USER, peut créer des annonces |
DECLINED | Vérification échouée | Peut réessayer via POST /kyc/init |
EXPIRED | Session expirée avant achèvement | Peut réessayer via POST /kyc/init |
Traitement du webhook
Lorsque Didit envoie le résultat via webhook (POST /v1/api/webhooks/didit) :
- APPROVED : le rôle de l’utilisateur est promu à
ROLE_VERIFIED_USER, ce qui active la création d’annonces
- DECLINED : l’utilisateur est notifié et peut réessayer
- EXPIRED : l’utilisateur est notifié et peut initier une nouvelle session
La vérification KYC est un processus unique. Une fois approuvé, l’utilisateur conserve son statut vérifié de manière permanente.
