---
title: "Hook-Katalog"
description: "Alle Ereignisse, auf die Plugins reagieren können – mit Zeitpunkt, Daten, Zustellung, Aufräum-Hooks und Regeln"
---

Mit Hooks reagiert ein Plugin auf Ereignisse in QuickTribe – etwa einen Beitritt, eine Zusage zu einem Event oder eine eingezogene Forderung:

```php
use App\Plugin\Api\Hook;
use App\Plugin\Api\HookEvent;

$registry->on(Hook::EventRsvp->value, function (HookEvent $event): void {
    $data = $event->data();   // eventId, occurrenceStart, membershipId, userId, via
    $this->notifyDriver((string) $event->communityId(), $data['eventId'], $data['occurrenceStart'], $data['userId']);
});
```

`on()` nimmt nur Namen aus dem Katalog (`Hook::…->value` oder den Text, z. B. `'event.rsvp'`); ein unbekannter Name wirft `InvalidRegistration`. Ein `HookEvent` liefert `name()`, `communityId()` (nur bei `account.deleted` `null`), `data()`, `occurredAt()` (Zeitpunkt der Aufzeichnung, UTC) und `isCleanup()`.

## Zustellung

- **Nach dem Speichern.** Der Kern zeichnet einen Hook in derselben Transaktion auf, in der er die Änderung speichert, und stellt ihn erst **nach dem Commit** zu – in einem Request, nachdem die Antwort an den Browser gegangen ist, auf der Konsole am Ende des Befehls, im Worker als eigener Auftrag im Plugin-Prozess. Wird die Transaktion zurückgerollt, entfällt der Hook. Der HTTP-Status der Antwort spielt keine Rolle: Gespeichert ist gespeichert.
- **Empfänger** sind Plugins, die plattformweit aktiv und in der betroffenen Community eingeschaltet sind; die adressierten Hooks `claim.*` gehen nur an das meldende Plugin (siehe [Forderungen](#forderungen)). **Aufräum-Hooks** (`member.left`, `event.deleted`, `account.deleted`, `isCleanup() = true`) gehen an alle plattformweit aktiven Plugins – auch an solche, die in der Community gerade ausgeschaltet sind.
- **Höchstens einmal**, ohne Wiederholung, in der Reihenfolge der Aufzeichnung. Listener müssen deshalb **idempotent** sein, und Plugins gleichen ihre Daten zusätzlich mit einem täglichen Job ab – über die Communities ihrer eigenen Tabellen, nicht nur die eingeschalteten (siehe [Abgleich und Löschfristen](/plugins/erweiterungspunkte#abgleich-und-löschfristen)).
- **Folge-Hooks**, die ein Listener auslöst (etwa über `members()->endMembership()`), laufen in der nächsten Runde; nach drei Runden verwirft der Kern weitere mit einer Warnung.
- **Fehler** eines Listeners stehen im Log (`plugin.<id>.hook_failed`); der nächste Listener läuft trotzdem. Braucht ein Listener länger als 2 Sekunden, gibt es eine Warnung; im Worker endet ein Listener spätestens nach 120 Sekunden Rechenzeit.

## Katalog

Alle IDs sind UUID-Strings, Zeitpunkte Text im Format `Y-m-d\TH:i:s\Z` (UTC). Die Daten enthalten immer genau die genannten Schlüssel; „oder `null`“ steht dabei, wo ein Wert fehlen kann.

| Hook | Wann | Daten |
| --- | --- | --- |
| `member.joined` | eine Mitgliedschaft entsteht oder wird nach einem Austritt erneuert – auch als wartende Beitrittsanfrage | `membershipId`, `userId`, `status` (`active`, `pending`), `via`, `inviteId` (oder `null`), `rejoin` (bool) |
| `member.approved` | eine wartende Beitrittsanfrage wird freigegeben | `membershipId`, `userId`, `actorUserId` |
| `member.left` *(Aufräumen)* | eine Mitgliedschaft endet oder eine Anfrage wird zurückgezogen bzw. abgelehnt | `membershipId`, `userId`, `reason`, `previousStatus`, `actorUserId` (oder `null`) |
| `member.unbanned` | eine Sperre wird aufgehoben | `membershipId`, `userId`, `actorUserId` |
| `member.role_changed` | die Rolle ändert sich – auch bei der Übergabe der Community (ein Hook je betroffener Mitgliedschaft) | `membershipId`, `userId`, `role`, `previousRole`, `actorUserId` (oder `null`) |
| `member.plan_started` *(ab 1.5)* | ein Plan, der Rechte gibt, beginnt: gekauft, kostenlos gebucht, vom Team vergeben, über einen Einladungslink mit Plan oder durch Freigabe einer kostenlosen Plan-Anfrage. Ende, Pause (Zahlungsproblem) und Verlängerung melden nichts | `membershipId`, `userId`, `planId`, `subscriptionId`, `via` (`purchase`, `free`, `grant`, `invite`, `plan_approval`) |
| `event.created` | ein Event wird angelegt – auch als Vorschau | `eventId`, `title`, `actorUserId`, `draft` (bool, ab 1.3), `schedule` |
| `event.updated` | ein Event wird erfolgreich gespeichert – bei jeder Änderung, auch wenn `changes` leer ist, und beim Veröffentlichen bzw. Zurückstellen einer Vorschau | `eventId`, `title`, `actorUserId`, `draft` (bool, ab 1.3), `scheduleChanged` (bool), `changes` |
| `event.deleted` *(Aufräumen)* | ein Event wird gelöscht – auch eine Vorschau; ersetzt `event.rsvp_cancelled` für alle seine Termine | `eventId`, `title`, `actorUserId`, `draft` (bool, ab 1.3), `schedule` (Stand vor dem Löschen) |
| `event.rsvp` | eine **neue** Zusage zu einem Termin entsteht (ein Wartelistenplatz ist keine Zusage) | `eventId`, `occurrenceStart`, `membershipId`, `userId`, `via` |
| `event.rsvp_cancelled` | eine Zusage entfällt | `eventId`, `occurrenceStart`, `membershipId`, `userId`, `reason` |
| `event.checked_in` | ein Ticket wird beim Check-in eingelöst | `eventId`, `occurrenceStart`, `membershipId`, `userId`, `actorUserId` |
| `event.check_in_undone` | ein Check-in wird zurückgenommen | `eventId`, `occurrenceStart`, `membershipId`, `userId`, `actorUserId` |
| `event.cancelled` *(ab 1.9)* | ein einzelner Termin wird abgesagt – von Hand durch das Team bzw. die Person, die das Event angelegt hat, oder automatisch, weil die Mindestteilnehmerzahl zum Stichtag nicht erreicht war. Bei Serien betrifft es nur diesen Termin; Zusagen und Wartelistenplätze bleiben bestehen | `eventId`, `occurrenceStart`, `title`, `kind`, `reason` (oder `null`), `actorUserId` (oder `null` bei der automatischen Absage) |
| `event.reinstated` *(ab 1.9)* | die Absage eines Termins wird zurückgenommen – er findet statt, alle Zusagen gelten weiter | `eventId`, `occurrenceStart`, `title`, `actorUserId` |
| `duty.booked` *(ab 1.6)* | ein Dienst wird übernommen: Zusage zu einem Dienst-Event (`slotId` `null`) oder Buchung eines Slots – selbst, vom Team eingetragen, nachgerückt, über eine Formular-Freigabe oder durch Slot-Wechsel | `eventId`, `occurrenceStart`, `membershipId`, `userId`, `dutyId`, `slotId` (oder `null`), `via` (`join`, `enrolled`, `promoted`, `form_approval`, `switched`) |
| `duty.released` *(ab 1.6)* | ein Dienst wird abgegeben oder entfällt | wie `duty.booked`, statt `via` ein `reason` (`cancelled` Absage, `removed` vom Team ausgetragen, `released` Mitgliedschaft endet, `slot_released` nur der Slot abgegeben – die Zusage bleibt, `slot_deleted` Slot entfernt, `switched` anderer Slot) |
| `duty.completed` *(ab 1.6)* | ein geleisteter Dienst beginnt zu zählen: der Kern schreibt ihn nach dem Ende eines Termins ins Ledger (alle 15 Minuten; bei Check-ins nur Eingecheckte) – verlangt die Community die Bestätigung durch das Team *(ab 1.9)*, erst, wenn das Team ihn bestätigt hat | `completionId`, `dutyId` (oder `null`), `eventId` (oder `null`), `occurrenceStart`, `membershipId`, `userId`, `year`, `source` (`event`, `slot`) |
| `points.changed` | eine Buchung im Punktekonto eines Mitglieds | `membershipId`, `userId`, `delta` (mit Vorzeichen), `reason`, `contextType` (oder `null`), `contextId` (oder `null`) |
| `account.deleted` *(Aufräumen, ohne Community)* | ein Konto wird gelöscht | `userId` |
| `claim.collecting` *(adressiert, ab 1.1)* | eigene Forderungen gehen in einen Einzugslauf (stornieren geht danach nicht mehr) | `source`, `runId`, `method` (`sepa_file`, `stripe`), `collectionOn` (`Y-m-d`), `claims`, `part`, `parts` |
| `claim.paid` *(adressiert, ab 1.1)* | der Einzug ist eingegangen (Stripe meldet den Eingang bzw. die Kasse bestätigt ihn) | `source`, `runId`, `paidAt`, `claims`, `part`, `parts` |
| `claim.returned` *(adressiert, ab 1.1)* | Einzug fehlgeschlagen oder zurückgebucht – die Forderungen sind wieder offen | `source`, `runId`, `collectionId`, `reason`, `feeClaimId` (oder `null`), `claims`, `part`, `parts` |
| `claim.reopened` *(adressiert, ab 1.1)* | Forderungen im Einzug sind wieder offen: ein angekündigter Einzug entfällt, oder die Kasse nimmt eine Einreichung zurück, die die Bank abgelehnt hat (eine Überfälligkeit von vorher gilt wieder) | `source`, `runId` (oder `null`), `reason`, `claims`, `part`, `parts` |
| `claim.settled` *(adressiert, ab 1.1)* | die Kasse (oder das Plugin mit `settleCash`) gleicht aus, auch in Teilen | `source`, `settlementId`, `method` (`cash`, `transfer`, `other`), `amountCents`, `actorUserId` (oder `null`), `claims`, `part`, `parts` |
| `claim.cancelled` *(adressiert, ab 1.1)* | eine eigene Forderung wird storniert (vom Plugin oder von der Kasse); ihre Referenz ist danach verbraucht | `source`, `reason`, `actorUserId` (oder `null`), `claims`, `part`, `parts` |
| `post.created` *(ab 1.2)* | ein Beitrag wird angelegt – veröffentlicht, als Entwurf oder geplant | `postId`, `title` (oder `null`), `restricted` (bool), `authorUserId`, `categoryId` (oder `null`), `status`, `isPublic` |
| `post.updated` *(ab 1.2)* | ein Beitrag wird gespeichert, zum geplanten Zeitpunkt veröffentlicht oder – weil die Person nicht mehr schreiben darf – statt dessen zum Entwurf | `postId`, `title` (oder `null`), `restricted` (bool), `actorUserId` (oder `null` bei den beiden geplanten Fällen), `status`, `changes`, `bodyChanged` (bool) |
| `post.deleted` *(Aufräumen, ab 1.2)* | ein Beitrag wird gelöscht | `postId`, `title` (oder `null`), `restricted` (bool), `authorUserId` (oder `null`), `actorUserId` |
| `comment.created` *(ab 1.2)* | ein Kommentar unter einem Beitrag, einer Lektion oder einem Event-Termin entsteht | `commentId`, `parentType` (`post`, `lesson`, `event`), `parentId`, `occurrenceStart` (nur bei Events, sonst `null`), `replyToId` (oder `null`), `authorUserId` |
| `lesson.completed` *(ab 1.2)* | ein Mitglied schließt eine Lektion ab (nur beim ersten Mal) | `lessonId`, `courseId`, `membershipId`, `userId`, `via` |
| `course.completed` *(ab 1.2)* | mit der letzten Lektion ist der ganze Kurs abgeschlossen | `courseId`, `membershipId`, `userId`, `certificateIssued` (bool) |
| `sequence.step_sent` *(ab 1.2)* | ein Schritt einer E-Mail-Serie ist bearbeitet – verschickt oder übersprungen | `sequenceId`, `enrollmentId`, `membershipId`, `userId`, `step` (ab 1), `trigger`, `eventId` (oder `null`), `occurrenceStart` (oder `null`), `emailed` (bool) |
| `form.submitted` *(ab 1.2)* | ein Formular ist abgeschickt (bei Bestätigung per Code: nach dem Code) | `formId`, `submissionId`, `userId`, `context`, `status`, `resubmitted` (bool) |
| `form.approved` *(ab 1.2)* | das Team gibt eine Einreichung frei | `formId`, `submissionId`, `userId` (oder `null`), `context`, `actorUserId` |

### Werte

| Schlüssel | Hook | Mögliche Werte |
| --- | --- | --- |
| `via` | `member.joined` | `join` (Beitritt bzw. Beitrittsanfrage), `invite` (Einladungslink, dann mit `inviteId`), `checkout` (Kauf eines Plans), `plan_approval` (Freigabe einer Plan-Anfrage durch das Team), `admin_appointed` (als Admin benannt) |
| `rejoin` | `member.joined` | `true`, wenn die Person schon einmal aktives Mitglied war |
| `reason` | `member.left` | `left` (ausgetreten), `withdrawn` (Anfrage zurückgezogen), `rejected` (Anfrage abgelehnt), `removed` (entfernt), `banned` (gesperrt), `expired` (bezahlte Mitgliedschaft abgelaufen bzw. Anfrage verfallen), `account_deleted` (Konto gelöscht) |
| `previousStatus`, `role`, `previousRole` | `member.*` | Status `pending`, `active`, `muted`, `banned`, `left`; Rollen `member`, `moderator`, `admin`, `owner` |
| `actorUserId` | `member.left` | die Person selbst bei `left`/`withdrawn`, `null` bei `expired` und `account_deleted` |
| `via` | `event.rsvp` | `join` (selbst zugesagt), `promoted` (von der Warteliste nachgerückt), `form_approval` (Zusage nach Freigabe eines Formulars), `enrolled` (vom Team eingetragen, ab QuickTribe 2.31 – zählt wie eine Zusage, auch bei überbuchtem Termin) |
| `kind` | `event.cancelled` | `min_attendees` (automatisch: Mindestteilnehmerzahl zum Stichtag nicht erreicht), `manual` (von Hand) |
| `reason` | `event.cancelled` | Grund einer Absage von Hand, wie ihn das Team eingegeben hat: reiner Text, höchstens 300 Zeichen, Zeilenumbrüche möglich; `null` ohne Angabe und bei der automatischen Absage |
| `reason` | `event.rsvp_cancelled` | `cancelled` (abgesagt), `released` (Platz frei geworden, z. B. durch Austritt, Entfernen oder Kontolöschung), `removed` (vom Team ausgetragen, ab QuickTribe 2.31) |
| `schedule` | `event.created`, `event.deleted` | `startsAt`, `endsAt` (UTC), `timezone` (IANA), `recurrence` (`none`, `weekly`, `monthly`, `monthly_weekday`), `recurrenceWeeks` (Liste aus 1–4 und -1 = letzter), `recurrenceUntil` (letzter Serientag als `Y-m-d` in der Zeitzone des Events oder `null`), `recurrenceEnd` (Ende dieses Tages in UTC oder `null`) |
| `changes` | `event.updated` | nur geänderte Schlüssel aus `startsAt`, `endsAt`, `timezone`, `recurrence`, `recurrenceWeeks`, `recurrenceUntil`, `location`, `postalCode`, `capacity`, `draft` (ab 1.3: Veröffentlichen bzw. Zurückstellen einer Vorschau), je `{before, after}`. `scheduleChanged` ist wahr, wenn sich einer der ersten sechs geändert hat |
| `occurrenceStart` | `event.*` | Beginn des Termins (UTC) – zusammen mit `eventId` der Vorkommens-Schlüssel `<eventId>\|<occurrenceStart>` |
| `claims` | `claim.*` | Liste mit je `claimId`, `reference`, `membershipId`, `amountCents`, `openCents`, `status` (höchstens 200 je Hook; mehr verteilt der Kern auf Folge-Hooks mit `part` 1 … `parts`) |
| `reason` | `claim.returned` | `insufficient_funds` (keine Deckung), `disputed` (Widerspruch), `revoked` (Mandat widerrufen), `account_closed`, `no_mandate`, `invalid_account`, `other` |
| `status` | `post.*` | `published`, `draft` (Entwurf), `scheduled` (geplant) |
| `changes` | `post.updated` | nur geänderte Schlüssel aus `title`, `categoryId`, `isPublic`, `status`, je `{before, after}`; `title` ist `{before: null, after: null}`, wenn der Beitrag vorher oder nachher `restricted` war; den Text selbst nennt kein Hook (`bodyChanged`) |
| `restricted` | `post.*` | `true`, wenn der Beitrag ein Entwurf bzw. geplant ist oder in einer Kategorie mit Plan-, Level- oder Alterssperre steht – dann ist `title` `null` |
| `via` | `lesson.completed` | `manual` (Knopf „Abgeschlossen“), `automatic` (Quiz bestanden, Video angesehen oder Abgabe freigegeben) |
| `trigger` | `sequence.step_sent` | Auslöser der Serie: `join`, `plan_started`, `manual`, `event` (dann mit `eventId` und `occurrenceStart`) |
| `emailed` | `sequence.step_sent` | `false`, wenn der Schritt ohne Mail übersprungen wurde (abbestellt oder Adresse ungültig) |
| `context` | `form.*` | `join` (Beitritt), `event:<eventId>` oder `plan:<planId>` |
| `status` | `form.submitted` | `completed` bzw. `awaiting_approval` (wartet auf die Freigabe durch das Team) |
| `reason` | `claim.reopened` | `run_cancelled` (Lauf verworfen oder Einreichung zurückgenommen – auch nach „bei der Bank eingereicht“ –, bei der Stripe-Lastschrift auch ein Einzug, den Stripe wegen eines Fehlers auf Stripe-Seite nicht ausgeführt hat), `account_deleted` (Konto gelöscht), `mandate_revoked` (Mandat beendet, oder die Bankverbindung ist nach einer Rückgabe wegen erloschenem bzw. ungültigem Konto gesperrt – das Mandat besteht dann weiter) |

## Regeln

- **`membershipId` bleibt stabil** je Person und Community, auch bei einem Wiedereintritt (`rejoin = true`).
- **Der Kern verschiebt keine Zusagen.** Nach `event.updated` mit `scheduleChanged` prüft das Plugin seine Termine mit `events()->occurrenceExists()`. Einzeltermine darf es auf den neuen Beginn umziehen (Versatz = `changes.startsAt.after` − `before`); Termine einer Serie, die es nicht mehr gibt, gelten als entfallen. Vergleiche mit dem Ende einer Serie immer gegen `recurrenceEnd`.
- **Warteliste:** Ein Wartelistenplatz löst keinen Hook aus; erst das Nachrücken (`event.rsvp` mit `via: promoted`).
- **Vorschau (Entwurf, ab 1.3):** Events kommen mit allen Hooks wie jedes andere – `event.created` schon beim Anlegen mit `draft: true`, `event.updated` bei jeder Änderung (Veröffentlichen und Zurückstellen als `changes.draft`), `event.deleted` immer. Das Plugin entscheidet selbst anhand von `draft`: An einer Vorschau gibt es keine Zusagen, Wartelistenplätze oder Tickets; Glocken, Mails oder Angebote, die eine Zusage voraussetzen, gehören erst zum veröffentlichten Event. `events()` liefert `draft` an `EventInfo`, `EventDraft` und `Occurrence` – an einem selbst gebauten `Occurrence` (eigener Konstruktor-Aufruf) ist `draft` nicht verlässlich, maßgeblich ist `events()->occurrence()` bzw. `events()->get()`. Die Slots `calendar.event.detail.aside` und `calendar.list.card.footer` erscheinen bei einer Vorschau nicht, der Editor-Slot schon; `extra` (Zusatzfelder, `validate()`, `store()`) läuft wie bei jedem Event.
- **Kontolöschung:** Zuerst kommen `member.left` mit `account_deleted` je Mitgliedschaft und `account.deleted`, danach ruft der Kern `PrivacyAware::deleteUserData()` (siehe [Datenschutz](/plugins/datenschutz)). So können Listener Betroffene – etwa Mitfahrer – noch benachrichtigen, bevor die Daten verschwinden.
- **Moderation:** Die Hooks folgen dem Wechsel des Status – eine Sperre ist `member.left` mit `banned`, das Aufheben `member.unbanned`; Freigabe `member.approved`, Ablehnung `member.left` mit `rejected`.
- Aufräum-Hooks erreichen auch Plugins, die in der Community ausgeschaltet sind: Ein Plugin räumt so seine Daten auf, selbst wenn der Owner es vorübergehend ausgeschaltet hat.
- **Beiträge (ab 1.2):** Geburtstags-Einträge lösen keine `post.*`-Hooks aus, Kommentare darunter kein `comment.created`. Hooks enthalten nie Inhalte – weder Text noch Antworten noch Kommentare –, nur IDs, Zustände und den Titel offener Beiträge.
- **Titel nie ungeprüft an Mitglieder ausgeben.** Auch ein offener Beitrag (`restricted: false`) kann später in eine gesperrte Kategorie wandern oder gelöscht werden. Wer Titel speichert und anzeigt, zeigt sie nur Personen, die den Beitrag selbst sehen dürfen, und aktualisiert bzw. entfernt sie bei `post.updated` und `post.deleted`.
- **Abgesagte Termine (ab 1.9):** Eine Absage entfernt keine Zusagen – es kommt kein `event.rsvp_cancelled` und kein `duty.released`, und `events()->isGoing()`, `goingKeys()` und `attendees()` liefern die Zusagen weiter. Solange der Termin abgesagt ist, nimmt der Kern für ihn keine Zusagen, Wartelistenplätze, Dienst-Slots und Check-ins an (also auch kein `event.rsvp`, `duty.booked`, `event.checked_in`), verschickt keine Erinnerungen und vergibt weder Punkte noch Dienst-Einträge; Schritte einer E-Mail-Serie entfallen (`sequence.step_sent` mit `emailed: false`). Dein Plugin sollte es genauso halten: für abgesagte Termine nichts erinnern und nichts Neues anbieten, Vorhandenes aber behalten – nach `event.reinstated` gilt alles wieder. Die Angemeldeten benachrichtigt der Kern selbst (Glocke, Push und eine E-Mail, die sich nicht abschalten lässt), bei Absage und Rücknahme. Den Zustand liest das Plugin mit `events()->isCancelled()` bzw. `cancelledKeys()`; `reason` ist Text des Teams und wird nur escaped ausgegeben.
- **Dienste (ab 1.6):** Ein Slot an einer bestehenden Zusage löst `duty.booked`, aber kein `event.rsvp` aus; `duty.released` mit `slot_released` lässt die Zusage bestehen. `duty.completed` kommt je Mitgliedschaft und Termin höchstens einmal – auch wer Dienst-Event und Slot zugleich hat, bekommt einen Eintrag (`source: slot`). Den Stand liest das Plugin über `duties()`. Mit Bestätigung durch das Team (ab 1.9) kommt `duty.completed` erst mit der Bestätigung (oder wenn die Community die Bestätigung ausschaltet) – für wartende und abgelehnte Dienste gibt es keinen Hook, und weil ein bestätigter Dienst bestätigt bleibt, auch keinen Widerruf.
- **Formulare (ab 1.2):** `form.approved` kommt nur für die Freigabe eines Formulars durch das Team; Beitritts- und Plan-Freigaben melden `member.approved` bzw. die Mitgliedschafts-Hooks.


## Forderungen

Die Hooks `claim.*` (ab Plugin-API 1.1, siehe [Forderungen und Lastschrift](/plugins/kern-dienste#forderungen-und-lastschrift)) sind **adressiert**: Sie gehen nur an das Plugin, das die Forderungen gemeldet hat (`source`), solange es plattformweit aktiv ist – auch wenn es in der Community ausgeschaltet ist –, und nie an andere Plugins. Forderungen der Kasse selbst lösen keine Hooks aus. Ein Hook bündelt alle Forderungen eines Laufs bzw. einer Aktion; das Plugin gleicht trotzdem regelmäßig über `debits()->list()` mit dem gespeicherten Cursor ab, weil Hooks höchstens einmal kommen.

- **Ein Hook je Lauf bzw. Aktion und Quelle:** `claim.collecting` und `claim.paid` je Einzug, `claim.returned`, `claim.settled` und `claim.cancelled` je Aktion der Kasse bzw. des Plugins. Mehr als 200 Forderungen verteilt der Kern auf Folge-Hooks mit `part` 1 … `parts`.
- **Wer auslöst:** Einzug ankündigen, als bezahlt markieren, Rücklauf erfassen, Einzug verwerfen, Einreichung zurücknehmen, ausgleichen und stornieren macht die Kasse; `settleCash()` und `cancel()` des Plugins lösen dieselben Hooks aus. Bei der **Stripe-Lastschrift** kommen `claim.collecting` (mit `method: stripe`) vom automatischen Lauf, `claim.paid` je Lastschrift, sobald Stripe den Eingang meldet (typisch sechs Bankarbeitstage nach dem Einzugstag), und `claim.returned` je Fehlschlag bzw. Rücklastschrift, die Stripe meldet. `claim.reopened` kommt, wenn Forderungen aus einem Einzug wieder offen werden:
  - Lauf verworfen (angekündigt oder Datei heruntergeladen) oder eine schon eingereichte Datei zurückgenommen, weil die Bank sie abgelehnt hat (`run_cancelled`); bei der Stripe-Lastschrift auch, wenn Stripe einen Einzug wegen eines Fehlers auf seiner Seite nicht ausführt (`run_cancelled`),
  - Mandat beendet oder Bankverbindung nach einer Rückgabe gesperrt (`mandate_revoked`) – nur Einzüge in noch nicht heruntergeladenen Läufen bzw. bei der Stripe-Lastschrift noch nicht bei Stripe eingereichte,
  - Konto gelöscht (`account_deleted`) – ebenso.
- **Rücklastschriftgebühr:** `feeClaimId` in `claim.returned` ist eine Forderung der Quelle `core` – das Plugin sieht sie nicht über `get()`, kann sie aber anzeigen („zzgl. Gebühr“).
- Einträge in `claims` liest man mit `ClaimRef::fromArray()`:

```php
use App\Plugin\Api\Hook;
use App\Plugin\Api\HookEvent;
use App\Plugin\Api\Model\ClaimRef;

$registry->on(Hook::ClaimReturned->value, function (HookEvent $event): void {
    $data = $event->data();
    foreach ($data['claims'] as $raw) {
        $ref = ClaimRef::fromArray($raw);   // claimId, reference, membershipId, amountCents, openCents, status
        $this->mirror->markReturned((string) $event->communityId(), $ref->reference, $data['reason']);
    }
});
```
