URL de base
Youverify propose deux environnements totalement isolés. Utilisez le sandbox pour l’intégration et les tests ; passez en production lorsque vous êtes prêt pour des vérifications réelles et facturées.Format des requêtes
Toutes les requêtes et réponses sont en JSON via HTTPS. Définissez les headers suivants pour chaque appel :Authentification
Youverify authentifie les appels de serveur à serveur avec un unique headertoken. Il n’y a pas de handshake OAuth : la possession de la clé secrète vaut autorisation, elle ne doit donc jamais quitter votre backend. Consultez la référence d’authentification pour les détails complets, les types de clés et les bonnes pratiques de sécurité.
Enveloppe de réponse
Chaque réponse réussie partage la même structure, ce qui vous permet d’écrire votre logique de désérialisation une seule fois :La charge utile principale : un objet pour les endpoints portant sur une seule ressource, un tableau pour les endpoints de liste.
Enveloppe d’erreur
Lorsqu’une requête échoue, la réponse reprend la même structure avecsuccess: false et un name d’erreur lisible par machine :
Un identifiant d’erreur lisible par machine, par exemple
ResourceNotFoundError, ValidationError, UnauthorizedError.Codes de statut HTTP courants
Pagination
Pagination par décalage
La plupart des endpoints de liste prennent en charge la pagination par décalage via les paramètres de requêtepage et limit :
data :
Pagination par curseur
Les flux à fort volume, tels que les Signals, prennent en charge la pagination par curseur, à privilégier pour l’interrogation en production car elle gère les données en temps réel sans omettre ni dupliquer d’enregistrements. Transmettez la valeurcursor renvoyée dans links comme paramètre de requête lors de l’appel suivant.
Identifiants d’entité
Toutes les entités portent un identifiant stable et globalement unique, préfixé parent_ :
Limites de débit
Youverify applique des limites de débit par espace de travail. Lorsque vous les dépassez, l’API renvoie429 Too Many Requests avec un header Retry-After indiquant le nombre de secondes à attendre avant de réessayer :
Groupes de ressources
L’API est organisée autour des groupes de ressources suivants :Entities
Créez, récupérez et gérez des entités de type particulier et entreprise. L’objet central auquel tout le reste fait référence.
KYC
Lancez des vérifications d’identité auprès des bases de pièces d’identité officielles : BVN, NIN, passeport, permis de conduire, etc.
KYB
Vérifiez des entreprises auprès des registres du commerce. Récupérez les informations d’immatriculation, les dirigeants, les actionnaires et les UBO.
AML
Filtrez les entités par rapport aux listes de PEP, aux bases mondiales de sanctions et aux sources de médias négatifs.
KYT
Ingérez des transactions et recevez des évaluations de risque et des signaux de fraude en temps réel pour la surveillance des transactions.
Cases
Ouvrez, mettez à jour et clôturez des dossiers d’investigation liés aux entités. La couche avec intervention humaine.
Signals
Récupérez les événements, schémas et alertes détectés par les pièges à fraude et les règles de surveillance.
Risk
Accédez aux scores de risque, à leur décomposition et à la configuration du modèle de risque de votre espace de travail.