Avec un webhook, Xendy envoie automatiquement une requête POST à ton URL lorsqu'un événement se produit. Tu choisis parmi trois événements :
- Enregistrements DNS incorrects (
dns-records.failed)
- Enregistrements DNS rétablis (
dns-records.recovered)
- Importation boutique en ligne échouée (
webshop-import.failed)
- Clique sur l'onglet Webhooks, puis sur Ajouter un webhook.
- Renseigne l'URL (https uniquement) et choisis les Événements.
- Clique sur Ajouter. Copie le secret webhook qui s'affiche : tu ne le verras qu'une seule fois.
Chaque message est au format JSON avec id, event, created_at et data, et contient les en-têtes Xendy-Event, Xendy-Delivery et Xendy-Signature. La signature te permet de vérifier que le message provient bien de Xendy. Xendy-Signature a la forme t=<horodatage>,v1=<signature> : la signature est un HMAC-SHA256 de <t>.<body> avec ton secret. Refuse les messages dont t date de plus de 5 minutes. Un exemple en JavaScript est disponible dans la documentation.
Réponds dans les 10 secondes avec un code de statut 2xx. Si la livraison échoue, Xendy réessaie après 1, 5 et 30 minutes. Si cinq événements consécutifs échouent complètement, Xendy met le webhook en Désactivé. Chaque tentative est visible dans l'onglet Activité, sous Webhook sortant.