Skip to main content
Bienvenue dans la documentation développeur de storekit. Cette section couvre tout ce dont tu as besoin pour créer des intégrations avec storekit.
Les webhooks sont la principale manière de s’intégrer à storekit. L’accès direct à l’API est actuellement en early access et n’est pas largement disponible. Le MCP marchand, qui expose les mêmes données de compte via le Model Context Protocol pour les clients IA, est en beta avec une liste d’attente.

Demander l’accès à l’API

L’API n’est pas encore accessible au public, et l’accès est accordé au cas par cas pendant sa phase d’early access. Pour en faire la demande, remplis le formulaire storekit MCP/API Access Request. Précise :
  • Ce que tu développes et le problème que cela résout
  • Les magasins ou le compte concernés par l’intégration
  • Les données ou actions dont tu as besoin (par exemple lire les commandes, mettre à jour la disponibilité des articles)
  • Le volume prévu de requêtes
L’équipe storekit examine chaque demande et délivre les clés API lors de l’onboarding. Si tu as une question non technique concernant l’accès, contacte le support.
La plupart des intégrations n’ont pas besoin de l’API. Si tu souhaites uniquement réagir aux événements qui se produisent dans tes magasins, les webhooks ne nécessitent aucune approbation : c’est une fonctionnalité sur abonnement que tu actives toi-même dans Settings → Developers.
Pas développeur ? Créer tes propres outils sur storekit explique comment construire des outils pilotés par webhooks (tickets de cuisine personnalisés, alertes, écrans en direct) avec des app builders IA comme Replit, Lovable et Bolt, à l’aide de prompts que tu peux coller tels quels.

Webhooks

Les webhooks te permettent de recevoir des notifications en temps réel lorsque des événements se produisent dans tes magasins storekit. Utilise-les pour :
  • Synchroniser les commandes avec ton POS, ton kitchen display ou ton système d’inventaire
  • Déclencher des automatisations lorsque des commandes sont passées, acceptées ou terminées
  • Surveiller l’état du magasin et la connectivité des imprimantes
  • Suivre les payouts vers tes comptes bancaires
  • Recevoir des paiements par lien de paiement lorsqu’un client règle via un lien de paiement partagé

Aperçu des webhooks

Découvre le fonctionnement des webhooks et comment les configurer.

Événements webhook

Parcours tous les types d’événements et payloads disponibles.

Vérifier les signatures

Sécurise ton intégration en vérifiant l’authenticité des webhooks.

Dépannage

Résous les problèmes courants liés aux webhooks.

MCP marchand

Le MCP marchand est un serveur MCP distant accessible à https://mcp.storekit.com/mcp qui permet à un client IA (Claude, ChatGPT, Cursor, Claude Code ou ton propre agent) de lire les commandes, menus, statistiques de ventes, remboursements, additions et liens de paiement d’un marchand, et de créer des codes de réduction et des liens de paiement, le tout limité à son compte. Les utilisateurs se connectent avec leur identifiant du dashboard. Il est en beta avec une liste d’attente : demande l’accès.

Aperçu du MCP marchand

Endpoint, transport, outils et limites.

Connecter ton agent IA

Les guides de configuration non techniques pour les marchands.

Agents de commande

Les pages de commande exposent leurs capacités directement à l’agent IA d’un client : les outils WebMCP pour un agent dans le navigateur du client, un endpoint MCP distant pour un assistant ailleurs, un profil UCP pour une plateforme de commerce et llms.txt pour les crawlers. Les quatre sont tournés vers le client et aucun ne nécessite d’accès à l’API. Les deux surfaces MCP lisent un menu et remplissent un basket ; le profil UCP et llms.txt sont en lecture seule. Les opérations du magasin restent dans le dashboard, avec les webhooks ci-dessus, l’API REST et le MCP marchand.

Aperçu des agents de commande

Les quatre surfaces côté client et celle que ton lecteur veut.

Outils WebMCP

Les outils qu’une page de commande enregistre auprès du navigateur.

Prise en main

  1. Configure un endpoint - Crée un endpoint HTTPS dans ton application pour recevoir les webhooks
  2. Enregistre ton endpoint - Ajoute l’URL de ton endpoint dans le tableau de bord storekit
  3. Vérifie les signatures - Implémente la vérification des signatures pour la sécurité
  4. Traite les événements - Traite les webhooks entrants et réponds avec un statut 2xx
storekit utilise Svix pour une livraison fiable des webhooks. Tu peux utiliser les bibliothèques Svix pour simplifier la vérification des signatures.