Activer le module

Rien à activer : un endpoint webhook se déclare par API, et reçoit dès sa création.

Développeur, Webhooks : créer un endpoint, choisir ses événements, et relire les livraisons passées. S'ouvre dans un nouvel onglet.

Ce que le compte doit porter

1Une URL en HTTPS, joignable publiquement, sans authentification HTTP.
2Le secret renvoyé à la création, conservé : il n'est jamais renvoyé ensuite.
3Un traitement idempotent, indexé par l'identifiant de livraison ou d'événement.

Si la condition n'est pas remplie

Sans vérification de signature, n'importe qui peut vous poster un faux événement. Sans idempotence, une réponse lente comptée comme un échec produit un doublon : Mobupay retente cinq fois.

Par où entrer

POSTCréer un endpoint webhook/api/v1/webhooksGETLister les endpoints webhook/api/v1/webhooks

Guides de recettes

Recevoir et vérifier un webhook4 étapes

Recevoir est facile. Vérifier la signature et rester idempotent est ce qui fait la différence en production.

Rattraper un événement manqué3 étapes

Après cinq tentatives, Mobupay abandonne. Le rattrapage est une lecture, pas un rejeu.