Entwickler / Webhooks
Mindestens-einmalige Zustellung
Bis zu 6 Zustellversuche mit exponentiellem Backoff
Lieferprotokolle und Statistiken pro Endpunkt
Live-Berichterstattung
Warenkorb
Kasse
Bestellungen
Zahlungen
Konflikte & Rückbuchungen
Behalten Sie Zahlungsstreitigkeiten und Rückbuchungen fest im Griff.
Auszahlungen
Verfolge Auszahlungen und deren Status.
Webhook-Lebenszyklus
Verwalte und überwache deine Webhook-Endpunkte.
CloudEvents 1.0
Events werden mindestens einmal zugestellt und unterliegen keiner globalen Reihenfolge. Nutzen Sie die Kombination aus source und id zur Deduplizierung, um Idempotenz an Ihrem Endpunkt zu gewährleisten. Dieselbe Event-ID wird niemals für zwei verschiedene Events verwendet.
Spezifikationsversion
Immer „1.0“. Wir nutzen plattformübergreifend die CloudEvents-Semantik.
Typ
Die Event-Typ-Kennung (z. B. cope.order.completed).
Quelle
Der ursächliche Dienst. Für Idempotenz zusammen mit der ID verwenden.
ID
Eindeutige Event-ID, die auch bei Wiederholungsversuchen stabil bleibt. Ideal zur Duplikatvermeidung.
Zeit
RFC 3339-Zeitstempel des Ereignisses.
Betreff
Die primäre Ressourcen-ID, auf die sich dieses Ereignis bezieht.
Daten
Die ereignisspezifischen Nutzdaten. Schema je nach Ereignistyp dokumentiert.
Sicherheitsmodell
Liefergarantien
5xx · Zeitüberschreitung
Nach Zeitplan wiederholen
Derselbe Event kann bei einer Wiederholung mehrfach zugestellt werden. Die Idempotenz an Ihrem Endpunkt liegt in Ihrer Verantwortung – führen Sie eine Deduplizierung anhand von source + id durch.
4xx
Nicht wiederholbar
4xx-Antworten werden als definitives „Dieses Event nicht zustellen“ interpretiert. Wir protokollieren sie und machen weiter. Kein erneuter Versuch.
Dauerhafter Fehler
Automatische Deaktivierung
Wiederholt fehlerhafte Endpunkte werden automatisch deaktiviert. In diesem Fall senden wir ein webhook.endpoint.auto_disabled-Event sowie eine E-Mail an den Besitzer.
Garantie i.
Mindestens-einmalige Zustellung.
Derselbe Event kann bei einer Wiederholung mehrfach zugestellt werden. Die Idempotenz an Ihrem Endpunkt liegt in Ihrer Verantwortung – führen Sie eine Deduplizierung anhand von source + id durch.
Garantie II
Keine globale Sortierung.
Ereignisse für denselben Betreff können in ungeordneter Reihenfolge eingehen. Ihr Endpunkt sollte keine bestimmte Sequenz voraussetzen. Verwenden Sie das time-Feld des Ereignisses, wenn die Reihenfolge für Ihre Verarbeitung wichtig ist.
Webhooks im Live-Betrieb
Aktuell und kommend
Reine HTTPS-Endpunkte mit HMAC-SHA256-Signierung und Replay-Schutz.
Live
CloudEvents 1.0 JSON-Payloads für alle Ereignistypen.
Live
At-Least-Once-Zustellung mit deterministischer Duplikatbereinigung basierend auf Quelle und ID.
Live
Wiederholungen mit exponentiellem Backoff (30s, 5m, 30m, 2h, 12h, max. 6).
Live
Automatische Deaktivierung bei wiederholten Fehlern, inklusive Benachrichtigung und E-Mail.
Live
Event-Abdeckung für Warenkorb, Checkout, Bestellung, Zahlung, Rückerstattung, Streitfall, Chargeback und Auszahlung.
Live
Schnittstellen-Verwaltung für Endpunkte mit CRUD-Operationen, Filterung von Abonnements nach Typ und einmaliger Rückgabe des Signierschlüssels.
Live
Synthetischer Test-Event, pro Endpunkt triggerbar.
Live
Einzelne und mehrfache Event-Wiederholungen (letzte 90 Tage).
Live
Zustellungs-Logs und Statistiken (Erfolgsquote, p99-Latenz) pro Endpunkt.
Live
Rotieren von Signing-Secrets mit Übergangsfrist. Bisher erfordert das Rotieren eines Secrets das Erstellen eines neuen Endpunkts. Die Rotation mit Übergangsfrist ist aktuell in Arbeit.
Bald
Endpunktspezifische PII-Schwärzung. Konfigurieren Sie individuell pro Endpunkt, welche Felder vor der Übertragung geschwärzt werden.
Bald
Zapier-, Make- und n8n-Konnektoren veröffentlicht. Integriere diese Tools ab sofort direkt über unsere Webhooks. Eigene verifizierte Konnektoren mit integrierter Authentifizierung folgen in Kürze.
Bald
Garantierte Reihenfolge und Exactly-Once-Zustellung stehen aktuell nicht auf unserer Roadmap. Das standardbasierte At-Least-Once-Modell ist von uns so gewollt. Die Idempotenz liegt dabei ganz auf Ihrer Seite.
Bald