Prévenir votre serveur
Ajouter à un lien de paiement un endpoint webhook qui prévient votre serveur à chaque paiement, billet, don ou remboursement, et gérer son secret de signature.
L'onglet Webhooks d'un lien envoie ses événements à une adresse de votre serveur, signés avec un secret propre à chaque endpoint. Toute personne qui voit les liens de paiement voit l'onglet ; ajouter, modifier ou supprimer un endpoint demande Gérer les liens de paiement. Ces actions, comme afficher ou régénérer le secret d'un endpoint, demandent le code de sécurité. Les liens n'existent qu'en Production. Le contenu des événements et la vérification de la signature sont décrits dans la documentation développeur : Les webhooks d'un lien.
Les étapes
Étape 1, Ouvrez l'onglet Webhooks
Sur la page du lien, ouvrez l'onglet Webhooks, puis Ajouter un endpoint.
Étape 2, Donnez l'adresse de votre serveur
Dans URL de l'endpoint, saisissez une adresse HTTPS publique de votre serveur.
Étape 3, Choisissez les événements
Sous Événements, cochez ceux que l'endpoint doit recevoir : Paiement terminé avec succès, Billet d'événement acheté, Don reçu, Commande passée, Paiement remboursé, ou perdu en litige et Lien expiré. Il ne reçoit que ceux-là.
L'endpoint ne reçoit que les événements cochés. Étape 4, Enregistrez l'endpoint
Ajouter un endpoint, en bas de la fenêtre, l'enregistre après le code de sécurité. Quand votre organisation a déjà autant d'endpoints que permis, la fenêtre le dit sous URL de l'endpoint : supprimez-en un dont vous ne vous servez plus pour en ajouter un autre.
Étape 5, Copiez le secret de signature
Dans le menu de l'endpoint, Afficher le secret de signature donne, après le code de sécurité, le Secret de signature que votre serveur utilise pour vérifier chaque envoi.
Étape 6, Envoyez un test
Envoyer un test, dans le menu de l'endpoint, envoie un événement d'essai et dit si votre serveur l'a accepté. Après trop de tests, le message dit quand réessayer. La Dernière livraison, sur la ligne de l'endpoint, ne compte que les vrais événements, avec le statut HTTP reçu.
Gérer un endpoint
Le menu de chaque endpoint propose aussi Copier l'URL et Modifier l'endpoint, où Actif désactivé garde ses réglages sans rien lui envoyer. Régénérer le secret de signature ouvre Régénérer le secret de signature ?, qui dit quand l'ancien secret cesse de marcher. Régénérer le secret, après le code de sécurité, signe les envois avec un nouveau secret et l'affiche sous Secret de signature : mettez-le sur votre serveur pour qu'il continue d'accepter les envois. Supprimer l'endpoint demande Supprimer cet endpoint ? : l'endpoint ne reçoit plus les événements du lien et son secret est perdu, sans retour possible.
Pour recevoir les événements de tous vos liens à la fois, utilisez plutôt les webhooks de la console développeur ; la liste de leurs événements est dans Liens de paiement.