Introduction
Sankara est une plateforme API-first pour l’identification et la vérification d’identité (KYC) et d’entreprise (KYB).
Elle aide les organisations à:
- ✅ Onboarder rapidement des clients et partenaires en toute conformité (AML/CFT)
- 🔍 Extraire et structurer les données de documents grâce à l’OCR
- 🧠 Valider la correspondance visage (selfie ↔ photo du document)
- 🛡️ Contrôler contre des bases externes (watchlists, PEP, adverse media)
- 📊 Décider via des scores, suivre la performance (KPI) et le risque (KRI)
Cas d’usage typiques
- Fintech et banques: ouverture de compte, virement, microcrédit
- Marketplaces: onboarding vendeurs, vérification KYB de sociétés
- Télécoms/Assurances: souscription à distance, eKYC
- Économie de plateforme: chauffeurs, coursiers, hôtes
Comment ça marche (vue d’ensemble)
- 🔑 Authentifiez vos requêtes avec une clé API
- 📤 Créez une vérification KYC/KYB et soumettez les documents (CI, permis, passeport, carte électorale, selfie)
- ⚙️ Le système traite: OCR, contrôles de cohérence, face match, vérifications externes
- 🔔 Recevez les événements via Webhooks signés (HMAC) et/ou consultez les statuts par API
- ✅ Récupérez le résultat détaillé: champs extraits, décisions, scores, erreurs éventuelles
Sécurité et conformité
- Authentification par clé API; idempotence via
Idempotency-Key - Webhooks signés HMAC avec secret dédié et vérification d’horodatage
- Chiffrement en transit (TLS). Bonnes pratiques de rotation et ségrégation des clés
- Journalisation et traçabilité (incluez
request_iddans vos logs)
Démarrer en 5 minutes
- Créez un compte entreprise et générez une clé API
- Configurez votre
webhook_urletwebhook_secret - Testez en sandbox, puis passez en production
- Explorez les endpoints KYC/KYB et intégrez vos parcours
Environnements
- Sandbox:
https://sandbox-api.sankara.africa - Production:
https://api.sankara.africa
Limites principales
- Formats: JPEG/PNG/PDF (1 page), taille ≤ 15 MB/fichier
- Quotas: 60 requêtes/min par clé API (par défaut)
- Images nettes et non rognées pour de meilleurs résultats OCR/face
Versioning et stabilité
- Version actuelle:
v1 - Les changements majeurs sont annoncés à l’avance; évitez les breaking changes sans migration
Support
- Besoin d’aide? Contactez votre support technique/CSM avec votre
request_id
Accès rapide
- Aperçu de l’API: Vérifications — Vue d’ensemble
- Authentification et sécurité: Clé API • Environnements
- Vérifications: KYC • KYB
- Webhooks (HMAC): Événements et signatures
- Erreurs et quotas: Erreurs • Limites
- Schémas: Objets principaux
- Plugins & Intégrations: Connecteurs