Lorsque vous réalisez une intégration via l’API FedaPay, il est possible que le statut final d’une transaction (appelée collecte dans l’API) ne soit pas immédiatement disponible. Cela arrive notamment lorsque le paiement se fait sans redirection ou lorsque l’utilisateur ferme la page avant la confirmation.

Pourquoi cela arrive ?

Plusieurs raisons peuvent expliquer l’absence du statut final :

• La transaction est encore en cours de traitement du côté Mobile Money ou carte bancaire.

• L’application n’interroge pas correctement l’API pour récupérer les mises à jour.

• Le webhook n’est pas configuré ou ne répond pas (erreur 400/500).

• Le serveur ne reçoit pas la notification automatique envoyée par FedaPay.

Pour garantir une récupération fiable, deux mécanismes doivent être mis en place.

1. Récupération manuelle : interroger l’API pour obtenir les détails d'une collecte

Pour vérifier manuellement le statut d’une transaction, vous devez effectuer une requête GET sur l’objet Collect.

➡️ Référence :  Récupération  du statut d’une transaction

⚠️ Cette approche ne suffit pas à elle seule si le client quitte la page ou si le réseau met du temps à répondre. C’est pourquoi les webhooks sont indispensables.

2. Récupération automatique : configurer un Webhook

FedaPay envoie automatiquement une notification vers votre backend dès qu’un statut final est disponible.

➡️ Référence : Configuration de Webhook pour récupérer le statut d'une transaction

Le webhook reçoit en temps réel :

• le statut final de la transaction

• le montant

• les informations clés de la collecte

• la signature de vérification

Pourquoi les webhooks sont indispensables ?

• Ils garantissent que vous recevez toujours le statut, même si l’utilisateur ferme l’application.

• Ils permettent de mettre à jour automatiquement votre base de données.

• Ils sont nécessaires pour une intégration back-end fiable (WooCommerce, API, mobile, etc.).

Points de vérification si vous ne recevez rien :

• L’URL du webhook est accessible publiquement (HTTPS).

• Votre serveur renvoie bien un code 200 OK.

• Le secret du webhook est correctement configuré.

• Les erreurs 400/500 sont corrigées dans vos logs.

Pour obtenir de manière fiable les statuts finaux de vos transactions :

• utilisez la requête GET pour vérifier manuellement une collecte;

• configurez un webhook pour recevoir automatiquement les statuts finaux.

Ces deux mécanismes combinés garantissent une intégration robuste et conforme aux bonnes pratiques des fintechs modernes.