Documentation Développeur

    Développez avec
    les APIs Sahl

    Connectez-vous à plus de 85 banques dans la région MENA et en Afrique avec une seule API. Commencez en quelques minutes avec nos SDKs, une documentation complète et un environnement sandbox.

    Démarrage Rapide

    En Production en 4 Étapes

    De l'inscription au premier appel API en moins de 10 minutes.

    1

    Obtenir les Clés API

    Inscrivez-vous pour un accès sandbox et recevez vos identifiants API en quelques minutes.

    2

    Installer le SDK

    Utilisez nos SDKs officiels pour Node.js, Python ou faites des appels API REST directs.

    3

    Connecter une Banque

    Utilisez notre widget prêt à l'emploi ou l'API directe pour initier les connexions bancaires.

    4

    Récupérer les Données

    Récupérez les comptes, les transactions et exécutez des vérifications.

    Installer un SDK

    JS
    Node.js
    npm install @sahl/node-sdk
    PY
    Python
    pip install sahl-python
    GO
    Go
    go get github.com/sahl/sahl-go
    {}
    REST API
    curl -X GET https://api.sahlfinancial.com/v1/
    Exemples de Code

    Voir en Action

    Copiez-collez des exemples pour connecter une banque et récupérer des transactions.

    import Sahl from '@sahl/node-sdk';
    
    const sahl = new Sahl({
      apiKey: process.env.SAHL_API_KEY,
      environment: 'sandbox' // or 'production'
    });
    
    // Create a connection session
    const session = await sahl.connect.createSession({
      customerId: 'user_123',
      redirectUrl: 'https://yourapp.com/callback',
      country: 'MA', // MA, TN, EG, NG, AE, SA
    });
    
    // Redirect user to session.connectUrl
    
    // After user connects, fetch their accounts
    const accounts = await sahl.accounts.list({
      customerId: 'user_123'
    });
    
    // Get transactions for an account
    const transactions = await sahl.transactions.list({
      accountId: accounts[0].id,
      fromDate: '2024-01-01',
      toDate: '2024-12-31'
    });
    
    console.log(`Found ${transactions.length} transactions`);
    Référence API

    Explorateur API Interactif

    Testez les endpoints directement dans votre navigateur. Cliquez sur n'importe quel endpoint pour l'étendre et l'essayer.

    Authentification

    Toutes les requêtes API nécessitent trois identifiants dans les headers. Votre Client ID et Client Secret identifient votre application, tandis que le Bearer token (qui tourne périodiquement) autorise la requête. Obtenez vos identifiants depuis le tableau de bord après inscription.

    # Required headers for all API requests
    X-Client-Id: your_client_id
    X-Client-Secret: your_client_secret
    Authorization: Bearer sk_live_your_rotating_token
    
    # Token rotation: Bearer tokens expire every 24 hours
    # Use the /v1/auth/token endpoint to refresh

    Méthodes de Connexion Bancaire

    Sahl supporte plusieurs méthodes de connexion selon la banque et la région. Notre API sélectionne automatiquement la méthode optimale pour chaque institution.

    Open Banking
    Europe & Middle East

    PSD2 / OAuth 2.0

    Accès sécurisé basé sur des tokens via les APIs bancaires officielles. L'utilisateur s'authentifie directement avec sa banque (Authentification Forte du Client), et nous recevons des tokens d'accès délégués. Aucun identifiant stocké.

    Regions: EU (PSD2), UK, UAE, Saudi Arabia, Qatar
    Basé sur les Identifiants
    Africa & Legacy

    Agrégation d'Écran Sécurisée

    Pour les banques sans APIs ouvertes, les utilisateurs fournissent leurs identifiants bancaires via notre widget sécurisé. Les identifiants sont chiffrés (AES-256) et utilisés pour agréger les données. Consentement utilisateur requis.

    Regions: Morocco, Tunisia, Egypt, Nigeria
    // Connection method is determined automatically based on bank
    const session = await sahl.connect.createSession({
      customer_id: "cust_123",
      redirect_url: "https://yourapp.com/callback",
      country: "FR",  // France - will use PSD2/OAuth 2.0
      bank_code: "BNPAFRPP"  // Optional: pre-select bank
    });
    
    // For credential-based banks (e.g., Morocco)
    // User enters credentials in our secure widget
    // Response includes connection_method for transparency
    {
      "id": "sess_abc",
      "connect_url": "https://connect.sahl.ma/sess_abc",
      "connection_method": "oauth2",  // or "credentials"
      "auth_flow": "redirect"  // OAuth: redirect | Credentials: embedded
    }
    Supported Banks
    OAuth 2.0
    Credentials
    85 banks
    Considérations MENA

    Considérations MENA

    Variabilité Bancaire

    La disponibilité des données varie selon les banques. Notre API normalise les réponses et indique la disponibilité des champs.

    Pistes d'Audit du Consentement

    Logs d'audit complets pour la conformité réglementaire. Suivez les octrois de consentement, les révocations et l'accès aux données.

    Support Arabe

    Descriptions de transactions et noms de marchands disponibles en arabe et en anglais.

    Banque Islamique

    Support complet des produits bancaires islamiques incluant Murabaha, Ijara et comptes à partage de bénéfices.

    Fonctionnalités

    Latence 142ms p99

    Infrastructure optimisée dans la région MENA avec des endpoints régionaux pour des réponses à faible latence.

    Sécurité Niveau Bancaire

    Basé sur le framework SOC 2. Toutes les données chiffrées en transit (TLS 1.3) et au repos (AES-256).

    85+ Intégrations Bancaires

    Une seule API pour se connecter aux principales banques des régions MENA et Afrique.

    SLA 99.99% de Disponibilité

    Fiabilité de niveau entreprise avec basculement automatique et surveillance en temps réel.

    Commencer à Développer Aujourd'hui

    Obtenez un accès sandbox et commencez à intégrer Sahl dans votre produit.

    Nous respectons votre vie privée

    Nous utilisons des cookies pour améliorer votre expérience de navigation, analyser le trafic et personnaliser le contenu. En cliquant sur 'Tout Accepter', vous consentez à notre utilisation des cookies. En savoir plus