Webhookfouten

Symptoom A: Webhook-eindpunt retourneert 4xx/5xx

Controleren: Dashboard → Eigenschap → Webhooks → Afleveringslog — toont statuscodes en antwoordlichamen.

Oorzaken en oplossingen:

Statuscode	Waarschijnlijke oorzaak	Oplossing
401	Handtekeningverificatie mislukt	Controleer uw verificatiecode — zie Webhook-beveiliging
400	Uw eindpunt weigert het payloadformaat	Log de ruwe body en vergelijk met het payload-schema
404	Eindpunt-URL is veranderd	Werk de webhook-URL bij in Eigenschap → Webhooks → [Webhook] → Bewerken
500	Bug in uw webhookhandler	Controleer uw serverlogboeken op de fout
timeout	Uw eindpunt reageert te langzaam	Reageer onmiddellijk met 200, verwerk asynchroon

---

Symptoom B: Handtekeningverificatie van webhook mislukt

Oorzaak: Meest voorkomende redenen:

1. Ondertekeningstring onjuist opgebouwd — moet {timestamp}.{raw_body} zijn (niet geparseerde JSON)
2. Gebruik van een ander geheim dan het geheim weergegeven in het Dashboard
3. Lezen van een gebufferde/gewijzigde body in plaats van de ruwe bytes

Oplossing: Zorg dat u de ruwe verzoekbody leest vóór enige JSON-parsing. In Express:

// MOET raw body middleware gebruiken
app.use('/webhooks', express.raw({ type: '*/*' }));

---

Symptoom C: Webhookafleveringen zijn vertraagd

Oorzaak: ConsentForge herprobeert mislukte afleveringen met exponentiële terugval — vertragingen zijn verwacht na initiële fouten.

Oplossing: Los de onderliggende fout op (zie Symptoom A). Zodra uw eindpunt 2xx retourneert, worden toekomstige afleveringen onmiddellijk.

---

Symptoom D: Ontbrekende afleveringen — gebeurtenissen niet ontvangen

Controleren: Vergelijk het afleveringslogaantal in het Dashboard met het ontvangen aantal op uw server.

Oorzaak: Sommige gebeurtenissen hebben alle pogingen uitgeput (5 pogingen over ~2 uur).

Oplossing: Eigenschap → Webhooks → Afleveringslog → Filter: Mislukt — gebruik de knop Herspelen om mislukte afleveringen opnieuw te verzenden.