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
- Faites activer l’API partenaire sur votre espace (activation par espace par Sahl, pas en libre-service) : demandez un accès bac à sable.
- Dans la console, ouvrez Settings, puis API Keys, puis New key. Cochez
kyc:extractetkyc:verify. Copiez le secret une seule fois. Gardez-le sur votre serveur.
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 unereference (votre identifiant du client) pour enregistrer le résultat dans un dossier.
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 dedocuments 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.