Skip to main content
Benvenuto nella documentazione per sviluppatori di storekit. Questa sezione copre tutto ciò che ti serve per creare integrazioni con storekit.
I webhook sono il modo principale per integrarsi con storekit. L’accesso diretto all’API è attualmente in early access e non è ampiamente disponibile.

Richiedere l’accesso all’API

L’API non è ancora pubblicamente disponibile e l’accesso viene concesso caso per caso finché è in early access. Per richiederlo, compila il modulo storekit MCP/API Access Request. Includi:
  • Cosa stai costruendo e il problema che risolve
  • Per quali negozi o account è destinata l’integrazione
  • I dati o le azioni di cui hai bisogno (ad esempio leggere gli ordini, aggiornare la disponibilità degli articoli)
  • Volume previsto di richieste
Il team storekit esamina ogni richiesta ed emette le API key durante l’onboarding. Se hai una domanda non tecnica sull’accesso, contatta il supporto.
La maggior parte delle integrazioni non ha bisogno dell’API. Se ti serve solo reagire a ciò che accade nei tuoi negozi, i webhook sono disponibili oggi e non richiedono approvazione.

Webhook

I webhook ti permettono di ricevere notifiche in tempo reale quando si verificano eventi nei tuoi negozi storekit. Usa i webhook per:
  • Sincronizzare gli ordini con il tuo POS, display di cucina o sistema di inventario
  • Attivare automazioni quando gli ordini vengono effettuati, accettati o completati
  • Monitorare lo stato del negozio e la connettività delle stampanti
  • Tracciare i pagamenti verso i tuoi conti bancari
  • Ricevere pagamenti tramite payment link quando un cliente paga attraverso un link di pagamento condiviso

Panoramica dei webhook

Scopri come funzionano i webhook e come configurarli.

Eventi webhook

Sfoglia tutti i tipi di eventi e payload disponibili.

Verifica delle firme

Metti in sicurezza la tua integrazione verificando l’autenticità dei webhook.

Risoluzione dei problemi

Risolvi i problemi comuni con i webhook.

Per iniziare

  1. Configura un endpoint — Crea un endpoint HTTPS nella tua applicazione per ricevere i webhook
  2. Registra il tuo endpoint — Aggiungi l’URL del tuo endpoint nella dashboard storekit
  3. Verifica le firme — Implementa la verifica delle firme per la sicurezza
  4. Gestisci gli eventi — Elabora i webhook in arrivo e rispondi con uno stato 2xx
storekit utilizza Svix per una consegna affidabile dei webhook. Puoi usare le librerie Svix per semplificare la verifica delle firme.