Dépannage des webhooks

​

Échec de la vérification de signature

​

Non-utilisation du corps de payload brut

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

​

Mauvaise clé secrète

• Assurez-vous d’utiliser le secret correct pour chaque endpoint (les secrets sont uniques par endpoint)
• Supprimez le préfixe whsec_ avant le décodage base64

​

Horodatage expiré

​

Webhooks non reçus

​

Endpoint inaccessible

• Assurez-vous que votre serveur est en cours d’exécution et que l’URL de l’endpoint est correcte
• Vérifiez que les règles de pare-feu autorisent les requêtes HTTPS entrantes
• Vérifiez que l’endpoint fonctionne avec un simple test curl

​

Problèmes SSL/TLS

​

Codes de réponse incorrects

​

Renvoyer des erreurs pour des traitements réussis

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

​

Timeouts

​

Le traitement prend trop de temps

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

​

Récupération après échec

​

Réactiver un endpoint désactivé

1. Corrigez le problème sous-jacent
2. Allez dans Settings > Webhooks dans le tableau de bord
3. Cliquez sur Enable Endpoint sur l’endpoint désactivé

​

Rejouer les messages échoués

1. Accédez aux détails de votre endpoint
2. Cliquez sur Options > Recover Failed Messages
3. Sélectionnez la plage horaire à rejouer