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

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 (EinstellungenEntwicklerManage 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.