​

Gestion des événements

​

Cycle de vie des transactions

1. Création de la transaction : Une fois que le client est créé, vous pouvez lui attribuer une transaction. Cela déclenche l’événement transaction.created.
2. Suivi des transactions : Une transaction peut évoluer de plusieurs façons :
   • transaction.approved : La transaction a été approuvée, ce qui signifie que le paiement a été validé.
   • customer.created : Lorsqu’un nouveau client est ajouté à votre compte, cela génère l’événement
   • transaction.declined: Le paiement a échoué ou a été refusé.
   • transaction.canceled : La transaction a été annulée avant sa finalisation.
   • transaction.transferred : Les fonds de la transaction ont été transférés au compte prévu (par exemple, vers un compte bancaire ou mobile money).
3. À chaque changement de statut, un nouvel événement est généré pour vous tenir informé. Par exemple, dès qu’une transaction est mise à jour, l’événement transaction.updated est déclenché.

​

Cycle de vie des clients

• customer.updated : Le profil du client a été modifié (par exemple, son nom ou son adresse e-mail).
• customer.deleted : Le client a été supprimé de votre compte.

​

Comment utiliser les événements ?

​

Pourquoi est-ce important ?

• Suivre vos paiements : Vous êtes informé en temps réel de l’état de chaque transaction.
• Administrer vos clients : Vous pouvez suivre les modifications apportées aux profils de vos clients.
• Automatiser vos processus : Grâce à la notification des événements, vous pouvez automatiser certaines tâches sur votre site, comme envoyer un e-mail de confirmation après un paiement réussi.

​

Introduction aux Webhooks

​

Pourquoi utiliser des Webhooks ?

• Des paiements réussis ou échoués
• Des remboursements
• Des transactions contestées

​

Comment fonctionnent les Webhooks ?

​

Configuration des Webhooks

1

Créer un Webhook

Pour recevoir des Webhooks, vous devez configurer une URL sur votre site qui pourra recevoir ces notifications. Suivez ces étapes :

• Connectez-vous à votre compte FedaPay.
• Accédez à la section Webhooks depuis le menu de votre tableau de bord.
• Cliquez sur Créer un Webhook ou Nouveau Webhook.
• Un formulaire s’ouvre avec plusieurs champs à renseigner:

Saisir l’URL de destination

• Entrez l’URL de votre site où vous souhaitez recevoir les notifications.
• Assurez-vous que cette URL est prête à traiter les Webhooks envoyés par FedaPay. Paramètres optionnels
• Désactiver la vérification SSL sur les requêtes HTTP (optionnel)
• Désactiver le Webhook lorsque l’application génère des erreurs (optionnel)

Ajouter des en-têtes HTTP

• Vous pouvez spécifier des en-têtes personnalisés en ajoutant des clés et valeurs.
• Cliquez sur le bouton ”+” pour ajouter plusieurs en-têtes si nécessaire.

Choisir les types d’événements

• Recevoir tous les événements (par défaut, vous recevrez toutes les notifications).
• Sélectionner les événements spécifiques (vous pouvez choisir uniquement ceux qui vous intéressent parmi la liste des événements disponibles).

Finalisation et activation

• Vérifiez que toutes les informations sont correctes.
• Cliquez sur Créer pour enregistrer et activer le Webhook.

2

Gérer vos Webhooks

Une fois vos Webhooks créés, vous pouvez :

• Modifier : Changez l’URL ou les événements que vous souhaitez suivre.
• Supprimer : Si vous n’avez plus besoin de ce Webhook, vous pouvez le supprimer.
• Consulter les détails : Vous pouvez voir toutes les informations sur le Webhook en question (URL, événements suivis, etc.).

​

Stratégie d’envoi des événements des Webhooks

• FedaPay enverra une requête HTTP de type POST avec les données de l’événement.
• FedaPay attend en retour une réponse avec un statut 2xx.
• Toute réponse différente d’un statut 2xx est considérée comme un échec.

​

Nouvelles tentatives automatiques

• En cas d’échec de la tache d’exécution, FedaPay réessaiera au maximum 9 fois à des intervalles exponentiels.
• Le temps d’attente pour réessayer ne dépasse pas 2 minutes.
• Après 10 essais sans succès, le webhook est automatiquement désactivé pour éviter une surcharge de la queue.
• Vous pouvez prévenir la désactivation en décochant l’option Désactiver le webhook lorsque l’application génère des erreurs dans votre tableau de bord.

​

Redéclenchement manuel

• Allez dans Logs de la page de votre webhook.
• Cliquez sur le bouton Re-déclencher.

​

Bonnes pratiques pour l’utilisation des Webhooks

​

Gérer les événements en double

• Enregistrez les identifiants des événements déjà traités pour ne pas les re-traiter.
• Utilisez l’identifiant de l’objet dans object ainsi que name pour identifier les doublons.

​

Écouter uniquement les types d’événements requis

• Configurez vos points de terminaison pour ne recevoir que les événements nécessaires.
• Évitez d’écouter tous les événements pour ne pas surcharger votre serveur.
• Modifiez les événements reçus via le tableau de bord.

​

Gérer les événements de manière asynchrone

• Utilisez une file d’attente asynchrone pour traiter les événements webhook sans bloquer votre système.
• Évitez le traitement synchrone, qui peut ralentir votre infrastructure et causer des échecs en cas de forte charge.
• Anticipez les pics de trafic, notamment lors des renouvellements d’abonnements en masse, pour éviter la surcharge des serveurs.
• Contrôlez le débit de traitement en ajustant la consommation des événements en fonction des capacités de votre système.

​

Recevoir des événements avec un serveur HTTPS

• Utilisation d’une URL HTTPS : FedaPay vérifie la sécurité de la connexion avant d’envoyer les webhooks.
• Certificat SSL valide : Votre serveur doit être correctement configuré avec un certificat valide pour éviter tout rejet de connexion.
• Compatibilité TLS : Seules les versions TLS v1.2 et v1.3 sont prises en charge par FedaPay.

​

Vérifier que les événements sont envoyés par FedaPay

const { Webhook } = require('fedapay')

// You can find your endpoint's secret key in your webhook settings
const endpointSecret = 'wh_sandbox...';

// This example uses Express to receive webhooks
const app = require('express')();

// Use body-parser to retrieve the raw body as a buffer
const bodyParser = require('body-parser');

// Match the raw body to content type application/json
app.post('/webhook', bodyParser.raw({type: 'application/json'}), (request, response) => {
  const sig = request.headers['x-fedapay-signature'];

  let event;

  try {
    event = Webhook.constructEvent(request.body, sig, endpointSecret);
  } catch (err) {
    response.status(400).send(`Webhook Error: ${err.message}`);
  }

  // Handle the event
  switch (event.name) {
    case 'transaction.created':
      // Transaction créée
      break;
    case 'transaction.approved'':
      // Transaction approuvée
      break;
    case 'transaction.canceled'':
      // Transaction annulée
      break;
    default:
      console.log(`Unhandled event type ${event.type}`);
  }

  // Return a response to acknowledge receipt of the event
  response.json({received: true});
});

app.listen(4242, () => console.log('Running on port 4242'));