Skip to main content

API Reference

L’API SahelPay est une API REST qui utilise JSON pour les requêtes et réponses.

Base URL

EnvironnementURL
Sandboxhttps://sandbox.sahelpay.ml
Productionhttps://api.sahelpay.ml

Authentification

Toutes les requêtes doivent inclure votre clé secrète dans le header Authorization :
Authorization: Bearer sk_test_xxx

Format des réponses

Succès

{
  "success": true,
  "data": {
    // Données de la ressource
  }
}

Erreur

{
  "success": false,
  "error": {
    "code": "INVALID_AMOUNT",
    "message": "Le montant doit être supérieur à 100 FCFA"
  }
}

Codes d’erreur HTTP

CodeDescription
200Succès
400Requête invalide
401Non authentifié
403Accès refusé
404Ressource non trouvée
429Rate limit dépassé
500Erreur serveur

Rate Limiting

L’API est limitée à 100 requêtes par minute par clé API. Headers de réponse :
  • X-RateLimit-Limit: Limite totale
  • X-RateLimit-Remaining: Requêtes restantes
  • X-RateLimit-Reset: Timestamp de reset

Idempotence

Pour éviter les doublons, utilisez le header X-Idempotency-Key :
X-Idempotency-Key: order-123
Les requêtes avec la même clé d’idempotence retournent le même résultat.