Passer au contenu principal
Chaque requête API Payfonte est authentifiée via deux en-têtes :
  • client-id
  • client-secret
N’exposez jamais client-secret dans des applications frontend, mobiles, dans le stockage navigateur ou dans des dépôts publics.

​
Modèle d’authentification

client-id

Identifiant public de votre compte et de votre environnement.

client-secret

Clé secrète utilisée pour autoriser les requêtes. Stockez-la uniquement sur des systèmes backend de confiance.

Auth basée sur les en-têtes

Envoyez les deux identifiants dans les en-têtes de chaque appel API.

Clés propres à l'environnement

Sandbox et production utilisent des identifiants différents. Ne les mélangez pas.

​
Où récupérer vos clés

1

Se connecter au dashboard

Utilisez sandbox-app.payfonte.com pour les tests ou app.payfonte.com pour les opérations live.
2

Ouvrir les paramètres des clés API

Accédez à Settings -> API Keys/Webhooks.
3

Copier les identifiants de manière sécurisée

Enregistrez client-id et client-secret dans des variables d’environnement côté serveur.

​
Exemple de requête

curl --location 'https://sandbox-api.payfonte.com/payments/v1/checkouts' \
  --header 'client-id: <your-client-id>' \
  --header 'client-secret: <your-client-secret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "reference": "test-001",
    "amount": 1000,
    "currency": "NGN",
    "country": "NG",
    "user": {
      "phoneNumber": "08012345678"
    }
  }'

​
Erreurs fréquentes

Sandbox et production sont deux environnements distincts. Utilisez toujours l’URL de base et les identifiants correspondants ensemble.
Le code frontend est visible par l’utilisateur final. Gardez tous les appels API Payfonte authentifiés sur votre backend.
Les requêtes sans client-id ou client-secret échouent à l’authentification.
Chargez toujours les identifiants depuis des variables d’environnement ou un gestionnaire de secrets sécurisé.

​
Checklist de sécurité

  • Conservez client-secret uniquement côté backend.
  • Utilisez HTTPS pour l’API et les endpoints webhook.
  • Faites tourner les identifiants si vous suspectez une fuite.
  • Restreignez l’accès interne aux secrets de production.

​
Documentation associée

Environnements

Configuration des URL et clés sandbox et production.

Premiers pas

Réussir votre premier appel API.

Référence API

Détails complets des endpoints et schémas.