Skip to main content
I webhook storekit vengono consegnati con semantica «at least once». Ciò significa che, in caso di problemi durante la consegna (ad es. problemi di rete), un webhook può essere occasionalmente consegnato più di una volta.

L’header svix-id

Ogni richiesta webhook include un header svix-id. Questo ID è:
  • Unico per messaggio — Ogni evento distinto riceve un ID univoco
  • Coerente tra i tentativi — Lo stesso ID viene utilizzato quando si ritenta una consegna fallita

Implementare la deduplicazione

Per assicurarti di elaborare ogni evento una sola volta, memorizza lo svix-id e controllalo prima di procedere:

Quando usare la deduplicazione

La deduplicazione è particolarmente importante per:
  • Elaborazione dei pagamenti — Evita di addebitare due volte i clienti
  • Creazione degli ordini — Previene ordini duplicati
  • Aggiornamenti dell’inventario — Garantisce conteggi delle scorte accurati
  • Invio di notifiche — Non inviare messaggi duplicati agli utenti

Opzioni di archiviazione

Puoi memorizzare gli ID dei webhook elaborati in:
Imposta una scadenza di almeno 72 ore (3 giorni) sugli ID dei webhook memorizzati. I tentativi possono verificarsi in un arco di circa 3 giorni, secondo la pianificazione dei tentativi.
Anche senza deduplicazione, progettare i tuoi handler webhook affinché siano idempotenti (producano lo stesso risultato se chiamati più volte) è una buona pratica.