Skip to main content
Se il tuo endpoint non restituisce una risposta di successo, storekit ritenterà l’invio del webhook più volte con backoff esponenziale.

Cosa conta come fallimento?

Una consegna webhook è considerata fallita se:
  • Il tuo endpoint restituisce un codice di stato diverso da 2xx
  • Il tuo endpoint non risponde entro 15 secondi
  • La connessione al tuo endpoint fallisce

Pianificazione dei ritentativi

I webhook falliti vengono ritentati con backoff esponenziale nell’arco di circa 3 giorni: Dopo che tutti i tentativi di ritentativo sono stati esauriti, il webhook viene contrassegnato come fallito.

Disabilitazione dell’endpoint

Se tutti i tentativi di consegna verso un endpoint specifico falliscono per un periodo di 5 giorni consecutivi, l’endpoint verrà disabilitato automaticamente per prevenire ulteriori consegne fallite. Per riattivare un endpoint disabilitato:
  1. Vai alla tua Dashboard storekit
  2. Naviga in Settings > Webhooks
  3. Trova l’endpoint disabilitato
  4. Clicca Enable Endpoint

Ritentativi manuali

Puoi ritentare manualmente i webhook falliti dalla dashboard:
  1. Vai ai dettagli dell’endpoint webhook
  2. Trova il messaggio fallito nei log
  3. Clicca Retry per rinviare

Recupero dopo interruzioni

Se il tuo servizio subisce un’interruzione, puoi recuperare i webhook persi:
  1. Vai al tuo endpoint nella dashboard
  2. Clicca Options > Recover Failed Messages
  3. Seleziona una finestra temporale da rieseguire
Progetta il tuo handler webhook in modo che sia idempotente, così ricevere lo stesso webhook più volte non causerà problemi.