Skip to main content

Webhooks aktivieren

Webhooks sind eine Abo-Funktion und müssen im Konto aktiviert werden, bevor Endpoints registriert werden können.
  1. Gehen Sie in der Seitenleiste des Dashboards zu Einstellungen → Entwickler
  2. Klicken Sie im Bereich Webhooks auf Enable Webhooks
  3. Sobald Webhooks aktiviert sind, heißt dieselbe Schaltfläche Manage Webhooks und öffnet die Webhook-Seite direkt
Wenn das Konto keinen Tarif mit Webhooks hat, zeigt die Seite anstelle der Einrichtungsansicht eine Schaltfläche Upgrade to enable webhooks.
Es gibt keinen Eintrag Webhooks direkt unter Einstellungen – Webhooks erreichen Sie über Einstellungen → Entwickler.

Endpoint hinzufügen

Die Webhook-Seite bindet ein sicheres Webhook-Portal ein. Die Verwaltung der Endpoints findet in diesem eingebetteten Portal statt, nicht in den storekit-eigenen Ansichten.
  1. Öffnen Sie die Webhook-Seite (Einstellungen → Entwickler → Manage Webhooks)
  2. Fügen Sie im eingebetteten Portal einen neuen Endpoint hinzu
  3. Geben Sie Ihre Endpoint-URL ein (z. B. https://example.com/webhooks/storekit)
  4. Wählen Sie die Event-Typen aus, die Sie empfangen möchten
  5. Speichern Sie Ihren Endpoint

Anforderungen an den Endpoint

Ihr Endpoint muss:
  • Öffentlich über HTTPS erreichbar sein
  • POST-Anfragen akzeptieren
  • Innerhalb von 15 Sekunden einen 2xx-Statuscode zurückgeben
  • CSRF-Schutz für diese Route deaktiviert haben

Event-Typen auswählen

Sie können bestimmte Event-Typen abonnieren oder alle Events empfangen. Wir empfehlen, nur die Events zu abonnieren, die Sie tatsächlich benötigen, um unnötigen Traffic zu vermeiden. Auf der Seite Webhook-Events finden Sie eine vollständige Liste der verfügbaren Events.

Endpoint testen

Bevor Sie live gehen, testen Sie Ihren Endpoint, um sicherzustellen, dass er korrekt funktioniert:
  1. Senden Sie ein Test-Event aus dem eingebetteten Webhook-Portal
  2. Prüfen Sie, ob Ihr Endpoint den Test-Webhook empfängt
  3. Verifizieren Sie, dass Ihr Endpoint eine 2xx-Antwort zurückgibt
Während der Entwicklung können Sie Tools wie webhook.site oder ngrok verwenden, um eingehende Webhooks zu inspizieren.