Skip to main content
L’API lit les documents (extract) et vérifie un profil (verify), deux des fonctions de Sahl pour les prêteurs et les banques. Les connexions bancaires et le scoring sont dans la console. C’est le flux réel de la v0.2.0. Pour un exemple plus long, voir le guide pas à pas, et pour essayer les appels sans code, voir Tester dans le sandbox.

Avant de commencer

  1. Faites activer l’API partenaire sur votre espace (activation par espace par Sahl, pas en libre-service) : demandez un accès bac à sable.
  2. Dans la console, ouvrez Settings, puis API Keys, puis New key. Cochez kyc:extract et kyc:verify. Copiez le secret une seule fois. Gardez-le sur votre serveur.
Définissez-le comme SAHL_API_KEY. Tous les exemples utilisent https://app.sahlfinancial.com/api, environment=sandbox et des données fictives. Utilisez une image de carte nationale d’identité (CIN) marocaine fictive de votre cru.

1. Lire un document

Envoyez 1 à 5 fichiers (JPEG, PNG, WebP, TIFF ou PDF, jusqu’à 30 Mo chacun). Ajoutez une reference (votre identifiant du client) pour enregistrer le résultat dans un dossier.
La réponse contient fields, documents, field_count, checks, reader_unavailable et policy. Avec une reference, elle contient aussi case_id et document_ids. Voir Lire des documents.

2. Vérifier le profil

Renvoyez les entrées de documents telles qu’elles sont arrivées, avec les champs dont vous disposez.

3. Lire le verdict

passed vaut true lorsqu’aucun contrôle critique n’a échoué. critical_failures et flags listent ce qui demande l’avis d’une personne. Un dossier sans pièce d’identité avec photo parmi ses documents échoue avec required:photo_id, donc envoyez les entrées de l’étape 1. /v1/kyc/assess prend le même corps et ajoute une évaluation du risque. Grâce à la reference, le dossier, ses documents et le verdict sont enregistrés dans votre espace de travail, où vos équipes les voient sous Cases et Documents.

Suite

Vérifier un profil

Chaque contrôle, ce qu’il renvoie, comment lire passed et flags.

Erreurs

Chaque statut et chaque code, avec la correction.