Start · Webhooks & Events
Webhooks & Events

Webhooks & Events

10 signierte Lifecycle-Events, um Florentin mit Drittsystemen und Automationen zu verbinden — Marketing, CRM, n8n, Make, Zapier. Mit Retries und Delivery-Logs.

Wozu Webhooks da sind

Deine eigene App braucht die Webhooks nicht — sie liest Florentin direkt über die API. Webhooks sind dafür da, dass andere Systeme reagieren: Florentin schickt signierte Events an deine Marketing-Plattform, dein CRM oder Automations-Tools wie n8n, Make und Zapier, sobald etwas passiert — ein Konto entsteht, ein Abo wird gekündigt, eine Rechnung wird erstellt.

Jede Zustellung ist HMAC-SHA256-signiert, trägt Event-, Timestamp- und Delivery-Id-Header und wird bei Fehlern automatisch wiederholt.

Events

Die 10 Events

EventAuslöser
account.createdNeues Konto angelegt
user.loginAnmeldung erfolgt
subscription.purchasedAbo abgeschlossen
invoice.createdRechnung erstellt
subscription.upgradedPlan hochgestuft
subscription.downgradedPlan herabgestuft
subscription.cancelledAbo gekündigt
team_member.addedTeam-Mitglied hinzugefügt
tos.acceptedAGB akzeptiert
usage.metrics_updatedNutzungsdaten aktualisiert

Zustellung

SignaturX-Florentin-Signature: sha256=<hmac>
HeaderX-Florentin-Event · -Timestamp · -Delivery-Id
Retries4 Versuche: 30 / 120 / 300 s.
LogsVersuche, Status, Replay.

Beispiel-Payload

POST /hooks/florentin
X-Florentin-Event: invoice.created
X-Florentin-Signature: sha256=8f3c9d…
X-Florentin-Delivery-Id: 7c1f…

{
  "event": "invoice.created",
  "timestamp": "2026-06-06T12:00:00.000Z",
  "data": {
    "invoice": { "id": "…", "number": "INV-0042",
                 "status": "open", "amount_due": 4900, "currency": "eur" }
  }
}
FAQ

Häufig gefragt

Wie verifiziere ich die Signatur?
Über das Secret: X-Florentin-Signature = sha256=HMAC-SHA256(secret, Rohbody).
Was passiert, wenn mein Endpoint down ist?
Florentin wiederholt bis zu 4× (Backoff 30 / 120 / 300 s) und protokolliert jeden Versuch.

Bau dein Produkt. Den Rest übernehmen wir.

Konten, Abrechnung, Credits, Portal, Zugriff — integriert. Stripe voll dabei.

Kostenlos starten