Skip to main content

​
Authentification

L’API SahelPay utilise des clés API pour authentifier les requêtes.

​
Clés API

Vous avez deux types de clés :
Ne jamais exposer votre clé secrète côté client (JavaScript frontend, application mobile). Utilisez-la uniquement dans votre backend. Une clé pk_... envoyée comme Bearer est refusée (401 INVALID_KEY_TYPE).

​
Utilisation

Incluez votre clé secrète dans le header Authorization :

​
Environnements

Le sandbox est un mode logique porté par les clés sk_test_... : utilisez la même base URL API. Avec metadata.sandbox: true, l’appel part vers l’environnement de test de l’opérateur ; avec metadata.sahelpay_mock: true, le simulateur SahelPay répond sans aucun appel opérateur. Ces deux métadonnées sont refusées en production.

​
Clé live : conditions d’utilisation

Une clé sk_live_... n’est acceptée que si l’accès production a été ouvert pour votre compte, après validation de votre demande et signature d’un contrat distinct précisant le périmètre et les rôles de chaque partie (ou contrat Partenaires SPAY validé). Sans accès production en cours, tout le compte fonctionne en sandbox : les clés live sont refusées (jamais simulées). Voir Passer en production.

​
Erreurs d’authentification

​
Régénérer vos clés

Si vous pensez que votre clé secrète a été compromise :
  1. Allez dans Dashboard → Développeurs → Clés API
  2. Cliquez sur Régénérer
  3. Mettez à jour votre application avec la nouvelle clé
La régénération invalide immédiatement l’ancienne clé. Assurez-vous de mettre à jour votre application rapidement.