Wie Lemon Squeezy fehlgeschlagene Abo-Zahlungen behandelt

Wenn eine Abo-Verlängerung bei Lemon Squeezy fehlschlägt, passiert vieles, ohne dass Sie etwas tun: Die Belastung wird erneut versucht, der Kunde erhält E-Mails, und das Abo durchläuft einige Status, bevor es endet. Genau zu wissen, was Lemon Squeezy tut und was es Ihnen überlässt, macht den Unterschied zwischen einem Kunden, der still verschwindet, und einem, der seine Karte aktualisiert.

Dieser Ratgeber geht diesen Ablauf Schritt für Schritt durch und gibt dann praktische Hinweise, die Sie in Ihrer eigenen App umsetzen können. Er hält sich an die Dokumentation von Lemon Squeezy: die Hilfeseite Recovery and Dunning, die Referenz des Subscription-Objekts, die Webhook-Ereignistypen und die Hilfeseite zu Abos (alle abgerufen im November 2026). Wo die Dokumentation etwas nicht sagt, sagen wir das.

Der Ablauf einer fehlgeschlagenen Zahlung bei Lemon Squeezy

Lemon Squeezy ist ein Merchant of Record: Es belastet den Kunden, führt die Wiederholungsversuche durch und versendet die Abrechnungsmails. Ihre Aufgabe ist vor allem, in Ihrer App auf Statusänderungen zu reagieren.

Schritt 1: Die Verlängerung schlägt fehl, und das Abo geht auf past_due

Laut der Referenz des Subscription-Objekts wird der Abo-Status past_due, wenn eine Verlängerungszahlung fehlschlägt. Das Abo durchläuft dann 4 Zahlungsversuche über einen Zeitraum von 2 Wochen. Gelingt einer davon, geht der Status zurück auf active.

Die Seite Recovery and Dunning ergänzt zwei Details:

• Während der Wiederholungsversuche gilt das Abo beim Zugang weiterhin als aktiv: Der Kunde nutzt Ihr Produkt weiter.
• Jeder fehlgeschlagene Versuch löst eine E-Mail aus, die den Kunden bittet, seine Zahlungsdaten zu aktualisieren.

Schritt 2: Die Versuche sind erschöpft, und das Abo wird unpaid

Schlagen alle Versuche fehl, wechselt der Status auf unpaid. Hier beginnt das Mahnwesen von Lemon Squeezy. Laut der Seite Recovery and Dunning werden Mahnmails über einen festgelegten Zeitraum versendet, und jede verlinkt auf eine Seite, auf der der Kunde seine Zahlungsdaten aktualisieren und reaktivieren kann.

Schritt 3: Das Mahnwesen endet, oder das Abo bleibt unpaid

Was danach passiert, hängt von Ihren Recovery-Einstellungen ab:

• Sie können eine Frist festlegen, nach der das Abo automatisch gekündigt wird. Danach kann der Kunde es nicht mehr reaktivieren.
• Sie können das Abo auf unpaid lassen, sodass der Kunde es jederzeit reaktivieren kann.
• Wenn Sie das Mahnwesen abschalten, bleibt der Status einfach unpaid, und Sie entscheiden, was das für den Zugang bedeutet.

Wenn das Mahnwesen abgeschlossen ist, sendet Lemon Squeezy subscription_expired, das laut der Seite zu Ereignistypen auslöst, „sobald das Mahnwesen für past_due-Abos abgeschlossen ist”.

PayPal ist anders

Die Recovery-Seite weist darauf hin, dass PayPal-Abos einem anderen Rhythmus für Wiederholungsversuche folgen, mit Versuchen alle 5 Tage. Wenn ein nennenswerter Teil Ihrer Kunden mit PayPal zahlt, gehen Sie nicht davon aus, dass der Zeitplan für Karten für sie gilt.

Die Status im Überblick

Status	Was er bedeutet	Sollte der Kunde Zugang haben?
active	Bezahlt und in Ordnung	Ja
past_due	Verlängerung fehlgeschlagen, Wiederholungsversuche laufen (4 über etwa 2 Wochen)	Ja, laut Lemon Squeezy
unpaid	Versuche erschöpft, Mahnwesen läuft oder ist abgeschaltet	Ihre Entscheidung; laut der Lebenszyklus-Dokumentation von Lemon Squeezy sollte der Zugang erst bei expired enden
cancelled	Gekündigt, in der Kulanzfrist bis ends_at	Ja, bis ends_at
expired	Beendet	Nein

Die Hilfeseite zu Abos sagt, dass Kunden in jedem Status außer expired Zugang behalten sollten. Manche Teams schränken Funktionen lieber ein, solange der Status unpaid ist; wenn Sie das tun, sagen Sie es in Ihrer App klar, damit der Kunde weiß, warum.

Die Webhooks, die Sie brauchen

Die Seite zu Ereignistypen listet die Abo-Ereignisse auf. Für fehlgeschlagene Zahlungen sind diese fünf wichtig:

Ereignis	Wann es auslöst	Payload
subscription_payment_failed	Eine Verlängerungszahlung schlägt fehl (nicht die erste Zahlung)	Subscription-Invoice-Objekt
subscription_payment_recovered	Eine Zahlung gelingt nach einem Fehlschlag	Subscription-Invoice-Objekt
subscription_payment_success	Jede erfolgreiche Zahlung; wird immer zusammen mit subscription_payment_recovered gesendet	Subscription-Invoice-Objekt
subscription_updated	Jede Änderung am Abo, einschließlich Statusänderungen	Subscription-Objekt
subscription_expired	Nachdem ein gekündigtes Abo endet oder sobald das Mahnwesen abgeschlossen ist	Subscription-Objekt

Zwei Dinge sind zu beachten. Erstens trägt subscription_payment_failed ein Subscription-Invoice-Objekt, nicht das Abo selbst; Sie rufen also meist das Abo ab, um seinen Status zu lesen. Zweitens sagt Lemon Squeezy, dass subscription_updated nach der Erstzahlung bei jeder Änderung auslöst; für viele Apps genügt es also, darauf zu hören und status zu lesen.

Die von uns genutzte Dokumentation beschreibt bei diesen Ereignissen kein Feld für einen Ablehnungsgrund, das mit den Ablehnungscodes der Kartennetzwerke vergleichbar wäre; bauen Sie also keine Logik, die davon abhängt, ohne Ihre eigenen Payloads zu prüfen.

Der Link zum Aktualisieren der Zahlung

Jedes Subscription-Objekt hat ein Attribut urls mit einem Link update_payment_method: eine vorab signierte URL, unter der der Kunde seine Karte ändern kann. Die Referenz des Subscription-Objekts sagt, dass diese signierten URLs 24 Stunden gültig sind, und der Leitfaden zur Verwaltung von Abos betont dasselbe für Recovery-Links: Rufen Sie das Abo erneut ab, um einen frischen Link zu erhalten, statt ihn zu speichern.

Das hat eine praktische Folge. Wenn Sie eigene E-Mails versenden, fügen Sie keinen gespeicherten Link in eine E-Mail ein, die vielleicht erst drei Tage später geöffnet wird. Verlinken Sie auf eine Seite in Ihrer App, die eine frische URL abruft und weiterleitet.

Recovery-Einstellungen konfigurieren

Die Mahnmails von Lemon Squeezy werden auf der Seite mit den Recovery-Einstellungen Ihres Stores konfiguriert. Laut der Seite Recovery and Dunning können Sie das Mahnwesen aktivieren oder deaktivieren und die E-Mails, Betreffzeilen, Inhalte und den Versandzeitplan bearbeiten, wobei Standardwerte vorgegeben sind.

Eine sinnvolle Einrichtung:

1. Lassen Sie das Mahnwesen an. Es kostet nichts und erreicht Kunden, die Ihre App nie öffnen.
2. Schreiben Sie den Standardtext in Ihrem Ton um. Sagen Sie, um welches Produkt es geht, was passiert, wenn die Karte nicht aktualisiert wird, und behalten Sie einen klaren Button.
3. Entscheiden Sie bewusst über die automatische Kündigung. Abos auf unpaid zu lassen, hält die Tür zur Reaktivierung offen. Automatisches Kündigen gibt Ihnen ein klares Enddatum. Wählen Sie eines und passen Sie die Zugangsregeln Ihrer App daran an.
4. Testen Sie es. Im Testmodus von Lemon Squeezy können Sie Webhook-Ereignisse simulieren und so prüfen, wie Ihre App auf past_due, unpaid und expired reagiert, bevor ein echter Kunde darauf stößt.

Praktische Hinweise für heute

Das eingebaute Verhalten von Lemon Squeezy ist eine solide Grundlage. Die Lücken liegen meist auf Ihrer Seite der Integration.

1. Das Problem in Ihrer App zeigen

Abrechnungsmails werden gefiltert. Wenn ein Abo past_due oder unpaid ist, zeigen Sie in Ihrer App ein Banner mit einem Button zu Ihrer Route „Karte aktualisieren”. Das ist oft der Moment, in dem der Kunde am ehesten handelt, weil er das Produkt gerade nutzt.

2. Status ausdrücklich behandeln

Ordnen Sie jedem Status an einer Stelle in Ihrem Code eine Zugangsregel zu. Ein häufiger Fehler ist, alles außer active als „kein Zugang” zu behandeln, was past_due- und cancelled-Kunden aussperrt, die für ihren aktuellen Zeitraum bezahlt haben.

3. Webhooks prüfen und deduplizieren

Lemon Squeezy signiert jede Anfrage mit einem HMAC im Header X-Signature (Anfragen signieren) und wiederholt Antworten, die nicht 200 sind, bis zu drei weitere Male mit exponentiellem Backoff (Webhook-Anfragen). Prüfen Sie die Signatur gegen den Rohinhalt und machen Sie Ihren Handler so, dass er gefahrlos zweimal laufen kann.

4. Eine persönliche Nachricht senden

Die automatischen E-Mails decken die Mechanik ab. Eine kurze, schlichte Nachricht von einem echten Menschen („Ihre Karte ist nicht durchgegangen, hier ist der Link, antworten Sie, wenn etwas nicht stimmt”) kommt oft anders an. Senden Sie sie einmal, etwa wenn das Abo unpaid wird, nicht bei jedem fehlgeschlagenen Versuch.

5. Die Rückgewinnung verfolgen

Zählen Sie pro Monat die Ereignisse subscription_payment_failed und subscription_payment_recovered. Das Verhältnis ist Ihre eigene Rückgewinnungsquote, gemessen an Ihren Daten. Wenn sie sich nach einer Textänderung bewegt, wissen Sie, dass die Änderung wirkte.

So geht es mit NoChurn

Lemon Squeezy führt weiterhin die Zahlung, die Wiederholungsversuche und seine eigenen Mahnmails durch; NoChurn ersetzt das nicht. NoChurn liest Ihre Lemon-Squeezy-Webhooks, stellt jede fehlgeschlagene Zahlung in eine Zeitleiste und kann KI-geschriebene Rückgewinnungsmails ergänzen, die Sie vor dem Versand prüfen. Außerdem gibt es jedem Kunden einen Churn Score von 0 bis 100, und Streitfälle, die Lemon Squeezy als Merchant of Record bearbeitet, erscheinen schreibgeschützt. NoChurn ist kostenlos unter 300 $ MRR, mit allen Funktionen in jedem Plan (Ihre eigene E-Mail-Domain ab 9 $). Siehe NoChurn + Lemon Squeezy.