Webhooks

Développeurs

Les points de terminaison que nous appelons quand un événement survient chez vous — un paiement abouti, un versement échoué, un litige ouvert.

Sans point de terminaison, votre intégration doit interroger la plateforme en boucle. Avec, les issues vous sont poussées, signées.

Ajouter un point de terminaison

Une URL https, et la liste des événements qui vous intéressent. Aucun événement coché = tous.

Le secret de signature est affiché une seule fois, à la création.

Renouveler un secret, sans rien casser

C'est une manœuvre en deux temps, et c'est volontaire :

1. Renouveler ajoute un second secret. Les deux sont valides — votre point de terminaison a le temps d'accepter le nouveau.
2. Promouvoir fait du nouveau le seul valide.

Ne promouvez qu'une fois votre point de terminaison capable d'accepter le nouveau secret. Les livraisons signées avec l'ancien cessent d'être vérifiables immédiatement.

Un secret promu n'est plus lisible ici. Perdu, il se renouvelle — il ne se récupère pas.

Vérifier

Envoyer un événement de test fait une vraie livraison vers vos points de terminaison actifs et affiche le code de réponse et la durée. Si rien n'est abonné à l'événement, l'écran le dit plutôt que de laisser croire à un succès.

Mettre en pause arrête les livraisons sans supprimer la configuration.

Le détail livraison par livraison est dans Journaux développeur ; le format des messages est décrit dans le guide Webhooks.

— /dashboard/webhooks