Entreprise (KYB)

Cette section couvre la vérification d’entités juridiques (entreprises/ONG):

• 📄 Documents: registre du commerce, statuts, certificat d’immatriculation, preuve d’adresse, registre des actionnaires, pièces d’identité des représentants/UBOs
• 👥 Personnes liées: UBOs, représentants légaux (KYC associé)
• 🗄️ Données: raison sociale, RC/ID fiscal, adresse, secteur (NAF/NACE), pays
• 🔎 Contrôles: registres officiels, sanctions/watchlists, PEP, adverse media

Base API: https://api.sankara.africa

Créer une vérification KYB

POST /v1/kyb/verifications (Content-Type: application/json)

Exemple requête:

{
  "company": {
    "legal_name": "ACME SARL",
    "registration_number": "RC-BKO-2020-B-12345",
    "tax_id": "NIF-123456",
    "country": "ML",
    "industry": "Retail",
    "address": {"line1": "Rue 123", "city": "Bamako", "postal_code": "BKO", "country": "ML"}
  },
  "representatives": [{"first_name": "Awa", "last_name": "Traoré", "role": "legal_representative"}],
  "ubos": [{"first_name": "Kader", "last_name": "Sangaré", "ownership_percent": 60}],
  "documents": [
    {"type": "registration_certificate", "name": "rc.pdf"},
    {"type": "articles_of_association", "name": "statuts.pdf"},
    {"type": "proof_of_address", "name": "facture.pdf"}
  ],
  "metadata": {"internal_ref": "KYB-2025-0001"}
}

Réponse (201):

{"id": "kyb_ver_01JAA...", "status": "pending", "company": {"legal_name": "ACME SARL", "country": "ML"}, "links": {"self": "/v1/kyb/verifications/kyb_ver_01JAA..."}, "created_at": "2025-08-09T10:21:00Z"}

Idempotence recommandée: Idempotency-Key: <UUID>.

Récupérer une vérification KYB

GET /v1/kyb/verifications/{kyb_verification_id}

Lister les vérifications KYB

GET /v1/kyb/verifications?status=processing&limit=20&starting_after=...

Événements Webhook (KYB)

• kyb.verification.created, kyb.verification.processing, kyb.verification.completed, kyb.verification.failed, kyb.verification.needs_review

Voir la page Webhooks pour la vérification de signature HMAC.

Champs et types (POST /v1/kyb/verifications)

• Principe: très peu d’obligatoires; fournir davantage améliore les contrôles.

Objet company:

Champ	Type	Obligatoire	Description
legal_name	string	obligatoire	Dénomination sociale
registration_number	string	optionnel	Numéro d’immatriculation (RC)
tax_id	string	optionnel	Identifiant fiscal
country	string(ISO2)	obligatoire	Pays d’immatriculation
industry	string	optionnel	Secteur d’activité
address.line1	string	optionnel	Adresse
address.city	string	optionnel	Ville
address.postal_code	string	optionnel	Code postal
address.country	string(ISO2)	obligatoire	Pays

Tableau representatives[]:

Champ	Type	Obligatoire	Description
first_name	string	obligatoire	Prénom
last_name	string	obligatoire	Nom
role	enum	obligatoire	legal_representative
dob	string(YYYY-MM-DD)	optionnel	Date de naissance
nationality	string(ISO2)	optionnel	Nationalité

Tableau ubos[]:

Champ	Type	Obligatoire	Description
first_name	string	optionnel	Prénom
last_name	string	optionnel	Nom
ownership_percent	number(0..100)	obligatoire	Pourcentage de détention

Tableau documents[]:

Champ	Type	Obligatoire	Description
type	enum	obligatoire	registration_certificate
name	string	recommandé	Nom de fichier

Objet metadata (JSON libre):

Champ	Type	Obligatoire	Description
internal_ref	string	optionnel	Référence interne