Intégration API
Envoi de requêtes
L’intégration de la solution de paiement de FedaPay repose sur l’envoi de requêtes HTTPS à ses serveurs. Pour vous assurer que votre plateforme fonctionne correctement en mode test comme en production, il est essentiel de comprendre comment ces requêtes doivent être structurées et à quelles réponses vous pouvez attendre.
Structure des requêtes HTTPS
Lorsque vous interagissez avec l’API de FedaPay, vos requêtes HTTPS doivent suivre une structure spécifique pour être traitées correctement. FedaPay fournit deux environnements : un environnement de test et un environnement live. Chaque environnement a son propre ensemble de clés API (test et live), et chaque clé API doit être utilisée en fonction de l’environnement dans lequel vous opérez.Méthodes HTTPS supportées
L’API FedaPay supporte plusieurs méthodes HTTP, dont les principales sont :- POST : Pour envoyer des données et créer de nouvelles ressources (par exemple, une nouvelle transaction).
- GET : Pour récupérer des informations ou des ressources existantes (par exemple, les détails d’une transaction).
- PUT : Utilisé pour mettre à jour une ressource existante avec de nouvelles informations (par exemple, mettre à jour les détails d’une transaction).
- DELETE : Utilisé pour supprimer une ressource existante (par exemple, annuler une transaction).
URL des serveurs
Utilisé pour effectuer des tests sans impact réel sur votre compte.
Authentification
Vous devez inclure votre clé API dans l’en-tête HTTP de chaque requête. Selon que vous êtes en mode test ou live, vous utiliserez l’une des deux clés : Authorization: Bearer VOTRE_CLÉ_APIMode Test vs Mode Live
Mode Test
Avant de passer en mode Live, il est recommandé de tester votre intégration en mode test. Ce mode vous permet de simuler différentes opérations de paiement sans effectuer de transactions réelles. Vous devez créer un compte test, et utiliser les clés API test pour adresser vos requêtes à l’environnement de test.- Clés API Test : Ces clés ne peuvent être utilisées que sur le serveur de test.
- Transactions de test : Simulez des transactions avec des cartes et des numéros de téléphone fictifs pour voir comment votre système réagit.
Mode Live
Une fois que vous avez validé vos tests, vous pouvez passer en production en utilisant vos clés API live. Ce mode permet de réaliser des transactions réelles avec vos clients.Numéros de test pour les cartes et le mobile money
Pour tester votre intégration, FedaPay vous fournit des numéros de carte et des numéros de téléphone pour simuler des paiements réussis ou échoués. Vous devez utiliser ces numéros en mode test uniquement.| Numéro | Type de carte | Scénario |
|---|---|---|
| 4111111111111111 | Visa | Succès |
| 4242424242424241 | Visa | Échecs |
| 5555555555554444 | Mastercard | Succès |
| 4242424242424242 | Visa | Echecs |
Réponses de l’API
Chaque requête que vous envoyez à l’API FedaPay reçoit une réponse, que vous soyez en mode test ou live. Ces réponses sont formatées en JSON et contiennent des informations importantes sur le résultat de votre requête.Réponse réussie (200)
Une réponse réussie est généralement un code HTTP 200. Elle inclut les détails de la ressource créée ou consultée.Réponse en cas d’erreur
Si une erreur survient (mauvaise clé API, requête mal formée, etc.), l’API renvoie un code d’erreur spécifique (par exemple, 400, 401, 404, 500).Gestion des erreurs
Pour une gestion optimale de vos transactions, voici quelques pratiques recommandées en cas d’erreurs :- 400 Bad Request : Vérifiez que vos paramètres sont bien formatés et conformes aux spécifications de l’API.
- 401 Unauthorized : Assurez-vous que vous utilisez la clé API correcte (test ou live) et qu’elle est valide.
- 404 Not Found : Vérifiez que l’URL que vous utilisez est correcte et que la ressource existe.
- 500 Internal Server Error : Ces erreurs proviennent de l’API FedaPay. Si elles persistent, contactez l’assistance.