Développeurs

Webhooks

Le webhook handler doit rester sûr face aux livraisons répétées et aux pannes temporaires des systèmes downstream.

Vue d’ensemble

Événements de paiement, fiscalisation et rapprochement avec signatures, retries et traitement idempotent.

Traitement des événements

Acceptez l’événement, vérifiez la signature, stockez l’event id, répondez vite et déplacez la logique lourde dans une queue.

Pannes

Si le CRM ou l’ERP est temporairement indisponible, l’événement ne doit pas être perdu: utilisez retry et journaux d’erreurs d’intégration.

Comment utiliser cette page

Webhooks aide à aligner le scénario de paiement entre métier, développement et opérations. Avant le lancement, il faut fixer le canal de vente, la route fournisseur, les responsables webhook, la vérification du statut et le support client après paiement.

FAQ

What must a webhook handler do before changing an order?

It must verify the signature, store the event id and payload, confirm that the event was not processed before and only then update orders, invoices, fiscal jobs or CRM status.

Why should heavy business logic go to a queue?

A webhook endpoint should respond quickly. A queue makes it possible to retry CRM, ERP, e-mail or fiscal actions after temporary failures without losing the event.