Webhook-problemen oplossen

​

Signatuurverificatie mislukt

​

De ruwe payload-body wordt niet gebruikt

// WRONG - parsing and re-stringifying changes the format
const payload = JSON.parse(body);
verify(JSON.stringify(payload), headers); // Will fail!

// CORRECT - use the raw body
verify(rawBody, headers);

​

Verkeerde secret key

• Zorg dat je de juiste secret per endpoint gebruikt (secrets zijn uniek per endpoint)
• Verwijder de whsec_-prefix vóór het base64-decoderen

​

Timestamp verlopen

​

Webhooks worden niet ontvangen

​

Endpoint niet bereikbaar

• Zorg dat je server draait en dat de endpoint-URL correct is
• Controleer of firewallregels inkomende HTTPS-verzoeken toestaan
• Verifieer dat het endpoint werkt met een simpele curl-test

​

SSL/TLS-problemen

​

Verkeerde responsecodes

​

Foutcodes teruggeven bij succesvolle verwerking

// CORRECT
app.post('/webhooks', (req, res) => {
  queue.add(req.body); // Add to queue for async processing
  res.status(200).send('OK'); // Acknowledge immediately
});

​

Timeouts

​

Verwerking duurt te lang

app.post('/webhooks', async (req, res) => {
  // Don't do this - blocks the response
  // await processOrder(req.body);
  
  // Do this instead - queue for background processing
  await queue.add('process-webhook', req.body);
  res.status(200).send('OK');
});

​

Herstellen na mislukking

​

Uitgeschakeld endpoint weer inschakelen

1. Verhelp de onderliggende oorzaak
2. Ga naar Settings > Webhooks in het dashboard
3. Klik op Enable Endpoint bij het uitgeschakelde endpoint

​

Mislukte berichten opnieuw afspelen

1. Ga naar de details van je endpoint
2. Klik op Options > Recover Failed Messages
3. Kies het tijdsbereik dat je opnieuw wilt afspelen