Les événements sont des actions importantes qui se produisent dans votre compte FedaPay, comme la création d’une transaction ou la mise à jour d’un client. Comprendre comment fonctionnent ces événements vous permet de mieux gérer vos transactions et d’offrir une meilleure expérience à vos clients.
Chaque fois qu’un événement se produit, FedaPay le signale en temps réel via des notifications d’événements. Ces notifications peuvent être utilisées pour suivre et réagir à ce qui se passe dans votre compte, comme lorsqu’un paiement est approuvé ou un client est modifié.
Les transactions sur FedaPay suivent un cycle de vie, et chaque étape de ce cycle génère un événement particulier. Voici comment ça se passe :
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.
Suivi des transactions : Une transaction peut évoluer de plusieurs façons :
À 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é.
Les clients peuvent également faire l’objet d’événements spécifiques :
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.
Chaque événement contient des informations détaillées sur ce qui vient de se passer. Vous pouvez consulter tous ces événements dans la section Événements de votre tableau de bord FedaPay. Cela vous permet d’avoir un historique complet de toutes les actions importantes sur votre compte.
La gestion des événements vous aide à :
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.
Les Webhooks sont des notifications automatiques que FedaPay envoie à votre application ou site web lorsque des événements importants se produisent sur votre compte. Par exemple, vous pouvez recevoir un webhook lorsqu’une transaction est réussie ou contestée.
Ces notifications sont particulièrement utiles car elles vous permettent de rester informé en temps réel, sans avoir à vérifier manuellement ce qui se passe sur votre compte FedaPay.
Les Webhooks sont essentiels pour être alerté rapidement des actions importantes sur votre compte, comme :
Des paiements réussis ou échoués
Des remboursements
Des transactions contestées
Chaque fois qu’un événement se produit (par exemple, un paiement accepté), FedaPay crée un objet événement (Event). Cet objet contient toutes les informations pertinentes sur l’événement, comme le type d’événement (paiement réussi) et les détails associés.
Ensuite, FedaPay envoie cet objet à l’URL de votre choix (appelée point de terminaison) via une requête HTTP. C’est comme si FedaPay vous envoyait un message pour vous informer de ce qui s’est passé.
Créer un Webhook
Pour recevoir des Webhooks, vous devez configurer une URL sur votre site qui pourra recevoir ces notifications. Suivez ces étapes :
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
Choisir les types d’événements
Finalisation et activation
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.).
Lorsque vous définissez un point de terminaison webhook, FedaPay vous enverra les événements liés à ce point de terminaison lorsque ceux-ci seront déclenchés sur FedaPay.
FedaPay exécute chaque envoi d’événement webhook dans des tâches concurrentes.
il est préférable de bien faire le suivi de votre système et de prévenir les erreurs éventuelles. Suivez également nos recommandations pour une bonne implémentation de votre service
Les points de terminaison webhook peuvent parfois recevoir le même événement plusieurs fois. Vous pouvez éviter le traitement des événements en double en suivant les indications suivantes :
Pour éviter les problèmes de mise à l’échelle et garantir la stabilité de votre service, suivez ces recommandations :
Pour garantir la sécurité des webhooks, assurez-vous que votre serveur respecte les exigences suivantes :
Vérification des adresses IP
Vérification des signatures des webhooks
Chaque webhook est signé par FedaPay via l’en-tête X-FEDAPAY-SIGNATURE.
Vous pouvez vérifier ces signatures en utilisant :
Comment vérifier les signatures des webhooks ?
Récupération du secret du point de terminaison
Vérification de la signature
Outils pour vérifier les signatures
Prévenir les attaques par nouvelle tentative
Retourner rapidement une réponse 2xx
Les événements sont des actions importantes qui se produisent dans votre compte FedaPay, comme la création d’une transaction ou la mise à jour d’un client. Comprendre comment fonctionnent ces événements vous permet de mieux gérer vos transactions et d’offrir une meilleure expérience à vos clients.
Chaque fois qu’un événement se produit, FedaPay le signale en temps réel via des notifications d’événements. Ces notifications peuvent être utilisées pour suivre et réagir à ce qui se passe dans votre compte, comme lorsqu’un paiement est approuvé ou un client est modifié.
Les transactions sur FedaPay suivent un cycle de vie, et chaque étape de ce cycle génère un événement particulier. Voici comment ça se passe :
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.
Suivi des transactions : Une transaction peut évoluer de plusieurs façons :
À 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é.
Les clients peuvent également faire l’objet d’événements spécifiques :
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.
Chaque événement contient des informations détaillées sur ce qui vient de se passer. Vous pouvez consulter tous ces événements dans la section Événements de votre tableau de bord FedaPay. Cela vous permet d’avoir un historique complet de toutes les actions importantes sur votre compte.
La gestion des événements vous aide à :
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.
Les Webhooks sont des notifications automatiques que FedaPay envoie à votre application ou site web lorsque des événements importants se produisent sur votre compte. Par exemple, vous pouvez recevoir un webhook lorsqu’une transaction est réussie ou contestée.
Ces notifications sont particulièrement utiles car elles vous permettent de rester informé en temps réel, sans avoir à vérifier manuellement ce qui se passe sur votre compte FedaPay.
Les Webhooks sont essentiels pour être alerté rapidement des actions importantes sur votre compte, comme :
Des paiements réussis ou échoués
Des remboursements
Des transactions contestées
Chaque fois qu’un événement se produit (par exemple, un paiement accepté), FedaPay crée un objet événement (Event). Cet objet contient toutes les informations pertinentes sur l’événement, comme le type d’événement (paiement réussi) et les détails associés.
Ensuite, FedaPay envoie cet objet à l’URL de votre choix (appelée point de terminaison) via une requête HTTP. C’est comme si FedaPay vous envoyait un message pour vous informer de ce qui s’est passé.
Créer un Webhook
Pour recevoir des Webhooks, vous devez configurer une URL sur votre site qui pourra recevoir ces notifications. Suivez ces étapes :
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
Choisir les types d’événements
Finalisation et activation
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.).
Lorsque vous définissez un point de terminaison webhook, FedaPay vous enverra les événements liés à ce point de terminaison lorsque ceux-ci seront déclenchés sur FedaPay.
FedaPay exécute chaque envoi d’événement webhook dans des tâches concurrentes.
il est préférable de bien faire le suivi de votre système et de prévenir les erreurs éventuelles. Suivez également nos recommandations pour une bonne implémentation de votre service
Les points de terminaison webhook peuvent parfois recevoir le même événement plusieurs fois. Vous pouvez éviter le traitement des événements en double en suivant les indications suivantes :
Pour éviter les problèmes de mise à l’échelle et garantir la stabilité de votre service, suivez ces recommandations :
Pour garantir la sécurité des webhooks, assurez-vous que votre serveur respecte les exigences suivantes :
Vérification des adresses IP
Vérification des signatures des webhooks
Chaque webhook est signé par FedaPay via l’en-tête X-FEDAPAY-SIGNATURE.
Vous pouvez vérifier ces signatures en utilisant :
Comment vérifier les signatures des webhooks ?
Récupération du secret du point de terminaison
Vérification de la signature
Outils pour vérifier les signatures
Prévenir les attaques par nouvelle tentative
Retourner rapidement une réponse 2xx