🔗 Intégration API
Documentation du Webhook Konnect Payment
Aperçu de l'Endpoint
Lorsqu'un paiement est traité via Konnect, un webhook est déclenché pour notifier votre système de l'état du paiement.
Détails de la requête Webhook
Type de requête
- Méthode : GET
- Endpoint :
https://your_webhook.com
Paramètres
| Paramètre | Type | Description | Requis |
|---|---|---|---|
payment_ref | String | ID unique de référence de paiement | Oui |
Exemple de votre endpoint
https://www.monsite.tn/module/konnect/webhook?payment_ref=5f9498735289e405fc7c18acTraitement du Webhook
Étape 1 : Récupérer la référence de paiement
Extrayez le payment_ref des paramètres de la requête du webhook.
Étape 2 : Vérifier l'état du paiement
Utilisez le payment_ref récupéré pour obtenir l'état du paiement :
Erreurs courantes
| Erreur | Cause possible | Solution |
|---|---|---|
| Référence de paiement invalide | payment_ref incorrect ou expiré | Vérifiez l'ID de référence, assurez-vous qu'il soit valide et récent |
| Webhook non reçu | Problèmes réseau, pare-feu bloquant | Vérifiez la configuration réseau, assurez-vous que l'endpoint du webhook soit accessible |
| Échec d'authentification | Identifiants API incorrects | Vérifiez les clés API et les autorisations |
| Timeout | Réponse serveur lente | Implémentez une gestion des délais d'attente appropriée, vérifiez la performance du serveur |
Conseils de débogage
- Journalisez toutes les requêtes entrantes du webhook
- Implémentez une gestion d'erreurs robuste
- Vérifiez l'accessibilité de l'endpoint webhook
- Vérifiez les configurations réseau et pare-feu
Bonnes pratiques
- Validez toujours le
payment_ref - Implémentez l'idempotence pour gérer les webhooks en double
- Utilisez HTTPS sécurisé pour l'endpoint du webhook
- Journalisez et surveillez les interactions avec le webhook