Webhooks
Un webhook est une notification poussée en temps réel envoyée au système dorsal sous la forme de données utiles JSON par le biais de requêtes HTTP. Paysafe utilise des webhooks pour informer le système lorsque l’événement se produit. Il s’agit d’une notification asynchrone d’événements tels que les rétrofacturations, les retours, les paiements compensés et les paiements terminés.
Avantages
- Les webhooks sont plus efficaces que l’interrogation des données.
- La notification par webhook (y compris les points de données) n’est transmise que lorsque l’événement se produit, de sorte que le système dorsal est toujours à jour.
- Les partenaires souscrivent une seule fois aux événements webhooks et les notifications sont envoyées dès que l’événement se produit.
Les webhooks ne remplacent pas les rapports. Les webhooks fournissent des informations en temps réel qui permettent aux partenaires et aux marchands d’être informés des transactions. Paysafe recommande de compléter les webhooks par des rapports afin d’accéder à l’ensemble des données et des métadonnées.
Étapes pour recevoir des webhooks
- Connectez-vous au portail Netbanx.
- Allez à Paramètres > Notifications > Prélèvement automatique.
- Sélectionnez les événements que vous souhaitez surveiller.
- Indiquez le point de terminaison de votre webhook (URL HTTP) sur votre serveur local.
- Testez que votre point de terminaison webhooks fonctionne en cliquant sur le bouton Tester la connectivité.
- Sécurisez vos webhooks; utilisez la clé secrète HMAC pour vérifier la signature du webhook générée par Paysafe.
- Enregistrez la configuration
Signature de webhook
La notification du webhook comporte un en-tête de signature calculé à l’aide de l’algorithme suivant :
digest = HMAC_SHA256 (hmacKey, UTF 8 string containing the JSON webhook request body)
signature = base 64 (digest)
Le code qui a reçu le webhook répète cet algorithme et compare la valeur générée avec la valeur reçue dans l’en-tête.
Exemple d’en-tête :
Signature : UMaQ4h635wUc4hp60Z5ASBC/5UtqKybAldOkLv6ngc0=
Données utiles de webhook
Les données utiles de webhook comportent des informations sur l’événement qui s’est produit. Elle est liée à la ressource correspondante qui a déclenché l’événement. Les données utiles comportent également des attributs tels que l’horodatage, le sujet de l’événement et l’identifiant de la ressource.