Passer au contenu principal
Les webhooks notifient vos systèmes quand un paiement change d’état. Deux façons de les recevoir : par paiement via un webhook_url, ou à l’échelle du projet via un endpoint du dashboard.

​
Endpoints

Enregistrez un ou plusieurs endpoints de webhook pour le projet et choisissez quels événements chacun doit recevoir (ou tous). Orqex POST alors ces événements vers votre endpoint. Chaque endpoint est créé avec son propre secret de signature (whsec_…), affiché dans le dashboard pour le copier dans votre handler. Chaque livraison vers cet endpoint est signée avec ce secret via l’en-tête x-orqex-signature — voir vérifier l’authenticité.

​
Journaux de livraison

Le dashboard conserve les journaux de webhooks sortants : chaque livraison, son statut et corps de réponse, et le nombre de tentatives. Les livraisons en échec sont réessayées automatiquement (jusqu’à cinq fois). Utilisez les journaux pour déboguer votre handler.

​
Webhooks par paiement

Définir webhook_url à la création d’une intention ou d’un checkout livre les événements de ce paiement à l’URL fournie, en plus des endpoints du projet.
Les webhooks par paiement (envoyés à un webhook_url) ne sont pas signés — seuls les endpoints du projet le sont. Pour ces livraisons par paiement, re-récupérez le paiement via l’API pour agir sur son statut faisant autorité. Voir Webhooks.