Vue d’ensemble 🚀

Bienvenue dans l’API KYC/KYB. Cette API permet à vos applications business de:

• ✅ Soumettre des documents d’identité et un selfie pour vérification
• 🔍 Extraire des informations via OCR
• 🧠 Valider la correspondance visage selfie ↔ photo du document
• 🗃️ Optionnel: contrôler les données dans des bases existantes (watchlists, registres, etc.)
• 🔔 Recevoir des notifications en temps réel via Webhooks (HMAC)

Flux de bout en bout

1. 🔑 Authentifiez vos requêtes avec une clé API.
2. 📤 Créez une vérification et uploadez les documents (carte d’identité, permis, passeport, carte électorale, selfie).
3. ⚙️ Le système traite (OCR, checks de cohérence, matching visage, validations externes).
4. 🔁 Consultez le statut via l’API ou recevez les événements via Webhooks (HMAC signé).
5. 📄 Récupérez le résultat détaillé et les champs extraits.

Bases

• Formats supportés: image/jpeg, image/png, application/pdf (1 page pour PDF, sinon rejets), max 15 MB par fichier.
• Statuts: pending, processing, completed, failed, needs_review.
• Idempotence: utilisez Idempotency-Key pour les requêtes POST.

Types de documents pris en charge 🪪

• Carte d’identité (2 faces: front, back)
• Permis de conduire (2 faces: front, back)
• Passeport (page d’identité)
• Carte électorale (1 ou 2 faces selon pays)
• Selfie (image du visage, conditions de qualité recommandées)

URLs de base

• Sandbox: https://sandbox-api.sankara.africa
• Production: https://api.sankara.africa

Astuce: configurez les webhooks pour être notifié dès qu’une vérification est completed ou failed.