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. Il merchant MCP, che espone gli stessi dati dell’account tramite il Model Context Protocol per i client AI, è in beta con una waitlist.

​
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 non richiedono alcuna approvazione: sono una funzionalità in abbonamento che abiliti tu stesso da Settings → Developers.
Non sei uno sviluppatore? Costruisci i tuoi strumenti su storekit illustra come creare strumenti basati sui webhook (kitchen ticket personalizzati, avvisi, schermate in tempo reale) con app builder AI come Replit, Lovable e Bolt, usando prompt che puoi incollare così come sono.

​
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.

​
Merchant MCP

Il merchant MCP è un server MCP remoto su https://mcp.storekit.com/mcp che consente a un client AI (Claude, ChatGPT, Cursor, Claude Code o il tuo agente) di leggere gli ordini, i menu, le statistiche di vendita, i rimborsi, i conti e i payment link di un merchant, e di creare codici sconto e payment link, il tutto limitato al suo account. Gli utenti accedono con il proprio login della dashboard. È in beta con una waitlist: richiedi l’accesso.

Panoramica del merchant MCP

Endpoint, transport, strumenti e limiti.

Collega il tuo agente AI

Le guide di configurazione non tecniche per i merchant.

​
Agenti di ordinazione

Le pagine di ordinazione espongono le loro capability direttamente all’agente AI di un cliente: strumenti WebMCP per un agente nel browser del cliente, un endpoint MCP remoto per un assistente altrove, un profilo UCP per una piattaforma di commercio e llms.txt per i crawler. Tutte e quattro le superfici sono rivolte al cliente e nessuna di esse richiede l’accesso all’API. Le due superfici MCP leggono un menu e riempiono un carrello; il profilo UCP e llms.txt sono di sola lettura. Le operazioni del negozio rimangono con la dashboard, i webhook qui sopra, l’API REST e il merchant MCP.

Panoramica degli agenti di ordinazione

Le quattro superfici lato cliente e quale ti serve.

Strumenti WebMCP

Gli strumenti che una pagina di ordinazione registra con il browser.

​
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.