Risoluzione dei problemi con i webhook

​

Verifica della firma fallita

​

Non si utilizza il corpo del payload grezzo

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

​

Chiave secret sbagliata

• Assicurati di utilizzare il secret corretto per ciascun endpoint (i secret sono univoci per endpoint)
• Rimuovi il prefisso whsec_ prima della decodifica base64

​

Timestamp scaduto

​

Webhook non ricevuti

​

Endpoint non accessibile

• Assicurati che il tuo server sia in esecuzione e che l’URL dell’endpoint sia corretto
• Controlla che le regole del firewall consentano le richieste HTTPS in entrata
• Verifica che l’endpoint funzioni con un semplice test curl

​

Problemi SSL/TLS

​

Codici di risposta sbagliati

​

Restituzione di errori per elaborazioni riuscite

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

​

Timeout

​

L’elaborazione impiega troppo tempo

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

​

Recupero dai fallimenti

​

Riattivare un endpoint disabilitato

1. Correggi il problema alla radice
2. Vai in Settings > Webhooks nella dashboard
3. Clicca Enable Endpoint sull’endpoint disabilitato

​

Rieseguire messaggi falliti

1. Vai ai dettagli del tuo endpoint
2. Clicca Options > Recover Failed Messages
3. Seleziona l’intervallo di tempo da rieseguire