Configurazione dei webhook

​

Abilitare i webhook

I webhook sono una funzionalità in abbonamento e devono essere abilitati sull’account prima di poter registrare endpoint.

1. Nella barra laterale della dashboard vai su Settings → Developers
2. Nel pannello Webhooks clicca Enable Webhooks
3. Una volta abilitati i webhook, lo stesso pulsante diventa Manage Webhooks e apre direttamente la pagina dei webhook

Se l’account non ha un piano che include i webhook, la pagina mostra un pulsante Upgrade to enable webhooks invece della schermata di configurazione.

​

Aggiungere un endpoint

La pagina dei webhook incorpora un portale webhook sicuro e la gestione degli endpoint avviene all’interno di quel portale incorporato, non nelle schermate di storekit.

1. Apri la pagina dei webhook (Settings → Developers → Manage Webhooks)
2. Nel portale incorporato aggiungi un nuovo endpoint
3. Inserisci l’URL del tuo endpoint (ad es. https://example.com/webhooks/storekit)
4. Seleziona i tipi di eventi che vuoi ricevere
5. Salva il tuo endpoint

​

Requisiti dell’endpoint

Il tuo endpoint deve:

• Essere pubblicamente accessibile tramite HTTPS
• Accettare richieste POST
• Restituire un codice di stato 2xx entro 15 secondi
• Avere la protezione CSRF disabilitata per questa rotta

​

Scegliere i tipi di eventi

Puoi iscriverti a tipi di eventi specifici o ricevere tutti gli eventi. Consigliamo di iscriversi solo agli eventi che ti servono per minimizzare il traffico non necessario. Consulta la pagina Eventi webhook per un elenco completo degli eventi disponibili.

​

Testare il tuo endpoint

Prima di andare live, testa il tuo endpoint per assicurarti che funzioni correttamente:

1. Invia un evento di test dal portale webhook incorporato
2. Verifica che il tuo endpoint riceva il webhook di test
3. Verifica che il tuo endpoint restituisca una risposta 2xx