Types d’événements KYC
Vérification d’identité : identity.verification.completed
Youverify transmet cet événement lorsqu’une vérification d’identité sur une pièce d’identité officielle, telle qu’un BVN, un NIN ou une carte d’identité nationale, a fini d’être traitée. L’objet data contient l’enregistrement vérifié complet, y compris tous les champs validés.
Exemple de charge utile
Champs de la charge utile de vérification d’identité
Résultat de la vérification. Voir les valeurs de statut ci-dessous.
Vérification d’adresse : address.verification.completed
Youverify émet cet événement lorsqu’une tâche de vérification d’adresse physique ou numérique est terminée. L’objet data comprend le rapport complet de l’agent, les coordonnées géographiques, les détails du bien et les images.
Exemple de charge utile (particulier)
Champs de la charge utile de vérification d’adresse
Résultat communiqué par l’agent. Valeurs courantes :
VERIFIED, NOT_VERIFIED, UNABLE_TO_VERIFY.Valeurs de statut de vérification
Le champdata.status des événements d’identité peut prendre les valeurs suivantes :
Lorsque
status vaut pending, ne considérez pas la vérification comme échouée. Youverify transmettra un webhook identity.verification.completed de suivi dès que le fournisseur en amont aura répondu.Cas d’usage courants
Débloquer des fonctionnalités à la suite d'une vérification
Débloquer des fonctionnalités à la suite d'une vérification
Écoutez
identity.verification.completed avec allValidationPassed: true pour faire passer automatiquement un utilisateur à un niveau vérifié sur votre plateforme, en activant des plafonds de transaction plus élevés, des recharges de portefeuille ou d’autres fonctionnalités restreintes.Envoyer des notifications en temps réel à votre utilisateur
Envoyer des notifications en temps réel à votre utilisateur
À la réception de l’un ou l’autre événement KYC, déclenchez une notification dans l’application ou un e-mail pour informer votre utilisateur que sa vérification a réussi ou échoué.
Mettre à jour les enregistrements internes
Mettre à jour les enregistrements internes
Conservez le
verificationId, le status et les champs validés de la charge utile du webhook dans votre propre base de données afin de disposer d’une trace auditable de chaque résultat KYC à côté de l’enregistrement de votre utilisateur.Gérer correctement les vérifications en attente
Gérer correctement les vérifications en attente
Si la vérification d’identité d’un utilisateur renvoie
status: pending, affichez-lui un état « en cours » dans votre interface et passez-le à vérifié ou échoué dès l’arrivée du webhook de suivi.