Fehlerbehebung bei Webhooks

​

Signaturverifizierung schlägt fehl

​

Kein Roh-Payload-Body verwendet

// 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);

​

Falscher Secret Key

• Stellen Sie sicher, dass Sie das korrekte Secret für jeden Endpoint verwenden (Secrets sind pro Endpoint eindeutig)
• Entfernen Sie das Präfix whsec_ vor der Base64-Dekodierung

​

Zeitstempel abgelaufen

​

Webhooks werden nicht empfangen

​

Endpoint nicht erreichbar

• Stellen Sie sicher, dass Ihr Server läuft und die Endpoint-URL korrekt ist
• Prüfen Sie, ob Firewall-Regeln eingehende HTTPS-Requests erlauben
• Verifizieren Sie, dass der Endpoint mit einem einfachen curl-Test funktioniert

​

SSL/TLS-Probleme

​

Falsche Antwortcodes

​

Fehler bei erfolgreicher Verarbeitung zurückgeben

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

​

Timeouts

​

Verarbeitung dauert zu lange

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');
});

​

Wiederherstellung nach Fehlern

​

Deaktivierten Endpoint reaktivieren

1. Beheben Sie die zugrunde liegende Ursache
2. Gehen Sie im Dashboard zu Settings > Webhooks
3. Klicken Sie am deaktivierten Endpoint auf Enable Endpoint

​

Fehlgeschlagene Nachrichten wiederholen

1. Öffnen Sie die Details Ihres Endpoints
2. Klicken Sie auf Options > Recover Failed Messages
3. Wählen Sie den zu wiederholenden Zeitraum