Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.fapshi.com/llms.txt

Use this file to discover all available pages before exploring further.

Lors de l’interaction avec l’API de paiement Fapshi, il est important de comprendre comment le système répond aux différents types de requêtes. Cela vous permet de gérer correctement les erreurs et les transactions réussies dans votre application.

​
✅ Requêtes Réussies

Toute requête réussie renverra un code de statut HTTP 200, indiquant que l’opération a été correctement traitée.
Le contenu du corps de la réponse dépendra de l’endpoint utilisé, mais il sera toujours structuré au format JSON. Exemple de réponse pour une requête réussie : 
{
  "message": "Requête réussie",
  "link": "https://checkout.fapshi.com/payment/685ac112ea66cd72c5e6cf1e",
  "transId": "ll7J2fl4",
  "dateInitiated": "2025-06-25T11:34:04.450Z" 
}

​
❌ Requêtes Échouées

En cas d’erreur, Fapshi renverra un code d’erreur HTTP 4XX, selon la nature du problème :
  • 400 – Requête incorrecte (paramètres manquants ou mal formés)
  • 403 – Accès interdit (identifiants invalides)
  • 404 – Introuvable (ressource inexistante)
  • 429 – Trop de requêtes (limite de débit dépassée)
Le corps de la réponse contiendra toujours un champ message fournissant une explication claire du motif de l’échec. Exemple de réponse pour une requête échouée : 
{
  "message": "Identifiants API invalides"
}
Assurez-vous de toujours lire le champ message de la réponse afin d’identifier la cause de l’échec et d’orienter votre débogage.

​
Liste blanche IP

Si une ou plusieurs adresses IP sont ajoutées à la liste blanche sur le tableau de bord Fapshi, seuls les serveurs utilisant ces adresses IP peuvent effectuer des requêtes de création de transaction : Lorsqu’une ou plusieurs adresses IP sont en liste blanche, une requête de création de transaction provenant d’un serveur dont l’adresse IP n’est pas autorisée reçoit une réponse 403, même si vos identifiants API sont valides. Cette règle s’applique uniquement aux endpoints de création de transaction listés ci-dessus ; les autres requêtes API ne sont pas soumises à la liste blanche IP. Si l’adresse IP de votre serveur change fréquemment, il est préférable de ne pas ajouter d’adresse IP spécifique à la liste blanche. La liste blanche IP est une mesure de sécurité qui empêche des serveurs non reconnus de créer des transactions avec vos identifiants API.

​
🔁 Règles de Formatage des Requêtes

Pour éviter les échecs inattendus, respectez les règles suivantes :
  • Tous les corps de requête doivent être encodés en JSON.
  • Les requêtes GET ne doivent pas contenir de corps. Si un corps est inclus dans une requête GET, l’API retournera immédiatement une erreur.
Vous pouvez retrouver des implémentations des endpoints API dans différents langages de programmation sur notre repo GitHub SDK.
Besoin d’aide ? Contactez-nous à support@fapshi.com ou visitez notre Centre d’aide et support.