---
title: "Pläne und Zahlungen (ab 1.7)"
---

Version 1.7 erweitert die Zahlungen um vier Funktionen: Rechte bei fehlgeschlagenen Zahlungen pausieren, eine Umsatz-Übersicht, Pläne mit fester Laufzeit und Pläne, die nur nach Freigabe durch das Team gebucht werden können. Alles wird je Community unter **Einstellungen → Zahlungen** eingestellt; dort gibt es jetzt die Reiter *Konto und Pläne*, *Übersicht* (nur Owner), *Zahlungsprobleme* und *Anfragen* (Owner und Admins).

Für Betreiber gibt es keine neuen Umgebungsvariablen. Nötig sind nur ein laufender Worker und die zusätzlichen Webhook-Ereignisse (siehe [Nach dem Update auf 1.7](#nach-dem-update-auf-1-7)).

## Fehlgeschlagene Zahlungen und Karenzzeit

Schlägt die Abbuchung eines Abos fehl, meldet Stripe das Abo als *überfällig*. Ab 1.7 gilt dann:

1. Das Mitglied bekommt **einmal je Vorfall** eine Benachrichtigung und eine E-Mail („Zahlung für … fehlgeschlagen“). Die E-Mail lässt sich in den Kontoeinstellungen (Benutzermenü → **Account** → „E-Mail-Benachrichtigungen“, Haken „Eine Zahlung für meinen Plan ist fehlgeschlagen“) abschalten und ist standardmäßig an.
2. Während der **Karenzzeit** bleibt alles verfügbar. Ein Hinweis oben auf jeder Seite und unter *Pläne und Rechnungen* nennt das Datum, bis zu dem die Inhalte verfügbar bleiben.
3. Nach Ablauf der Karenzzeit **ruhen die Rechte des Plans**: Kategorien, Kurse, Events und Chats mit Plan-Bindung sind gesperrt, Plan-Abzeichen und Namensfarbe werden ausgeblendet. Die Mitgliedschaft selbst bleibt bestehen.
4. Sobald die Zahlung eingeht (`invoice.paid`), ist alles sofort wieder freigeschaltet.

Die Karenzzeit stellt der Owner unter **Zahlungen → Konto und Pläne → Fehlgeschlagene Zahlungen** ein: 0 bis 30 Tage, Standard 3; 0 pausiert sofort. Eine Änderung gilt auch für Fälle, die schon laufen.

<Note>
Die Pause betrifft nur Inhalte, die an einen Plan gebunden sind. Eine kostenpflichtige Community ohne Plan-Bindung (alle Kategorien und Kurse für alle Mitglieder) sperrt bei einer fehlgeschlagenen Zahlung nichts. Wer Inhalte pausieren will, bindet sie an den Plan.
</Note>

### Rechnung bezahlen und Kundenportal

Bei einem überfälligen Abo zeigt die Seite *Pläne und Rechnungen* zwei Knöpfe:

- **Rechnung bezahlen** öffnet die offene Rechnung auf der Zahlungsseite von Stripe (`invoice.stripe.com`).
- **Zahlungsmethode ändern** öffnet das Stripe-Kundenportal (`billing.stripe.com`). Dort lassen sich nur Zahlungsmethode und Rechnungsverlauf verwalten; Kündigen und Planwechsel bleiben in der Community.

Das Kundenportal wird beim ersten Aufruf automatisch im Stripe-Konto des Owners eingerichtet; der Owner muss dafür nichts tun. Nach der Rückkehr gleicht die Plattform das Abo sofort mit Stripe ab. Die Aufrufe sind auf 10 in 10 Minuten je Person begrenzt.

### Liste „Zahlungsprobleme“

Owner und Admins sehen unter **Zahlungen → Zahlungsprobleme** alle Mitglieder mit überfälligem Abo: Plan, seit wann die Zahlung aussteht, ob die Inhalte schon pausiert sind, Zahl der Zahlungsversuche und den nächsten Versuch von Stripe. Das Team bekommt dazu bewusst keine Benachrichtigung; die Zahl steht auch in der Übersicht.

### Was nach dem letzten Zahlungsversuch passiert

Wie oft Stripe eine Zahlung wiederholt und was danach geschieht, stellt der Owner im **eigenen Stripe-Dashboard** ein (*Einstellungen → Billing → Abonnements und E-Mails → Fehlgeschlagene Zahlungen verwalten*). Die drei Möglichkeiten wirken sich so aus:

| Einstellung in Stripe | Folge in der Community |
| --- | --- |
| Abo kündigen | Das Abo endet; hält kein anderer Plan die Mitgliedschaft, endet sie (nicht beim Team) |
| Abo als unbezahlt markieren | Die Inhalte des Plans bleiben pausiert, bis die Rechnung bezahlt ist |
| Abo überfällig lassen | Die Inhalte bleiben dauerhaft pausiert, die Mitgliedschaft läuft weiter |

<Tip>
Vor dem produktiven Einsatz einen Durchlauf im Stripe-Testmodus machen (Testkarte, die abgelehnt wird) – Bezeichnungen und Abläufe im Stripe-Dashboard ändern sich gelegentlich.
</Tip>

## Übersicht

**Zahlungen → Übersicht** (nur Owner) fasst die Zahlen der letzten zwölf Monate zusammen:

- Kennzahlen: Umsatz **netto** als Hauptzahl, brutto daneben, bezahlte Abos und die Zahl der Mitglieder mit Zahlungsproblem.
- Umsatz je Monat als Balkendiagramm (netto und Steuer, je Währung; Gutschriften als negative Monate), wahlweise als Tabelle.
- Umsatz je Plan und Kurs, Abonnenten je Plan (aktiv, in der Testphase, endet zum Periodenende, Zahlung ausstehend, vergeben) und Kurskäufe.
- CSV-Export für Umsatz und Abonnenten.

Die Übersicht liest nur die archivierten Rechnungen und Abos der Plattform; Stripe wird dafür nicht aufgerufen. Monate richten sich nach der Zeitzone des Betrachters. Rechnungen aus der Zeit vor 1.7 ordnet `app:billing:sync <slug>` nachträglich Plänen und Kursen zu.

<Note>
Gutschriften aus der Zeit vor 1.7 stehen mit Netto = Brutto im Archiv und haben keinen Bezug zur Rechnung. Sie zählen in der Übersicht deshalb auch dann, wenn die zugehörige Rechnung offen oder storniert ist.
</Note>

## Pläne mit fester Laufzeit

Im Plan-Formular lässt sich bei monatlichen und jährlichen Plänen der Haken **„Verlängert sich automatisch“** entfernen. Der Plan wird dann als **Einmalzahlung** für einen Monat bzw. ein Jahr verkauft – ohne Stripe-Abo:

- Die Laufzeit beginnt mit dem Kauf und endet von selbst; eine Kündigung ist nicht nötig und nicht möglich.
- Eine Testphase und Gutscheine mit Freimonaten gibt es für solche Pläne nicht.
- Während der Laufzeit kann der Plan **nicht verlängert** und nicht erneut gebucht werden. Nach dem Ablauf kann das Mitglied ihn als neue Buchung wieder kaufen; verlangt der Plan eine Freigabe, braucht es dafür eine neue Freigabe.
- Sieben Tage vor dem Ende bekommt das Mitglied eine E-Mail mit dem Enddatum. Diese E-Mail lässt sich nicht abschalten.
- Hält kein anderer Plan die Mitgliedschaft, endet mit dem Ablauf auch die Mitgliedschaft (nicht beim Team); in privaten Communities kann das Mitglied danach nicht selbst neu buchen.

Das Umschalten am Plan gilt nur für neue Buchungen. Die AGB-Vorlage enthält einen passenden Absatz; bereits übernommene AGB ändern sich nicht automatisch.

<Warning>
Feste Laufzeiten beendet der Worker alle fünf Minuten. Läuft der Worker nicht, enden die Pläne nicht und die Erinnerungen gehen nicht hinaus.
</Warning>

## Pläne nur nach Freigabe

Mit dem Haken **„Nur nach Freigabe buchbar“** im Plan-Formular fragen Mitglieder den Plan zuerst an:

1. Das Mitglied klickt in der Planwahl auf *Freigabe anfragen*. Hängt am Plan ein Formular, füllt es dieses vorher aus – die Antworten sind die Entscheidungsgrundlage. Eine eigene Nachricht gibt es nicht.
2. Owner und Admins bekommen eine Benachrichtigung und sehen die Anfrage unter **Zahlungen → Anfragen** mit den Formular-Antworten.
3. **Freigeben**: Ein kostenloser Plan wird sofort gebucht. Bei einem bezahlten Plan bekommt das Mitglied eine Benachrichtigung und eine E-Mail und kann **innerhalb von 14 Tagen genau einmal** buchen und bezahlen. **Ablehnen** verlangt eine Begründung, die das Mitglied per E-Mail erhält; eine erteilte Freigabe lässt sich nicht zurücknehmen.
4. Bleibt eine Anfrage sieben Tage offen, erinnert die Plattform einmal: das Team gesammelt per Benachrichtigung, das Mitglied per E-Mail.

Vergibt das Team den Plan direkt (Mitglieder → Profil → Plan vergeben) oder über einen Einladungslink mit Plan, gilt das wie eine Freigabe. Schaltet der Owner die Freigabepflicht später aus, werden offene Anfragen geschlossen.

## Nach dem Update auf 1.7

- **Webhook-Ereignisse ergänzen:** Am Stripe-Webhook der Plattform zusätzlich `checkout.session.expired`, `charge.refunded`, `charge.dispute.created`, `charge.dispute.closed`, `customer.subscription.paused`, `customer.subscription.resumed`, `invoice.marked_uncollectible`, `credit_note.updated` und `credit_note.voided` aktivieren (vollständige Liste unter [Konfiguration](/konfiguration#zahlungen-stripe)). Damit gibt ein abgelaufener Checkout einen reservierten Gutschein frei, und volle Erstattungen sowie verlorene Zahlungsstreits entziehen einen Kurskauf bzw. Einmalplan und kürzen die Provision im Empfehlungsprogramm (der Owner wird benachrichtigt).
- **Bestehende überfällige Abos:** Für Abos, die schon vor dem Update überfällig waren, beginnt die Karenzzeit mit dem Update. Mit `php bin/console app:billing:sync <slug>` (siehe [Betrieb](/betrieb#konsole)) holt die Plattform Zahlungsversuche und offene Rechnungen von Stripe nach und ordnet die jüngsten Rechnungen (Standard 50, mit `--limit` bis 100) Plänen und Kursen zu. Einmal je Community mit verbundenem Stripe-Konto ausführen.
- **Owner informieren:** Die Karenzzeit steht für alle Communities auf 3 Tagen. Wer überfällige Abos weiter unbegrenzt nutzen lassen will, entfernt die Plan-Bindung der Inhalte; eine Einstellung „nie pausieren“ gibt es nicht.
- **Rechte im Team:** Einstellungen zu Empfehlungsprogramm, PayPal-Auszahlungen und SMS ändert nur noch der Owner; Admins sehen sie weiterhin.

## Spätere Versionen

Mit 2.30.0 kommt die Event Destination dazu (`STRIPE_EVENT_SECRET`, siehe [Konfiguration → Ereignisse von Stripe](/konfiguration#ereignisse-von-stripe-event-destination) und [Updates → 2.30.0](/updates#2-30-0)); sie ersetzt auf Dauer den klassischen Webhook. Für Owner sichtbar:

- **1.8:** Im Plan-Formular die Schalter **„Bei neuen Events vorausgewählt“** und **„Bei neuen Kursen vorausgewählt“**: Neue Events bzw. Kurse sind dann schon an alle buchbaren Pläne mit diesem Schalter gebunden („Nur für Pläne“, Hinweis „Vorausgewählt durch Plan-Einstellung“). Bestehende Events und Kurse bleiben unverändert.
- **2.1.1:** Wer einen Plan wählt, bevor das Beitrittsformular ausgefüllt ist, muss ihn danach nicht erneut wählen: Nach dem Absenden ist der kostenlose Plan gebucht, beim bezahlten geht es direkt zur Zahlung (ein Gutscheincode bleibt erhalten), eine Plan-Anfrage wird gestellt bzw. ein noch fehlendes Plan-Formular folgt. Wartet ein Formular auf die Freigabe durch das Team, wird nicht gebucht. Dasselbe gilt, wenn eine Community das Geburtsdatum verlangt: Nach dem Speichern in den Kontoeinstellungen geht der Beitritt samt Plan automatisch weiter.
