Was passiert, wenn eine Zahlung bei Polar fehlschlägt

Polar verkauft Ihre Abos als Merchant of Record. Schlägt eine Abo-Verlängerung fehl, übernimmt Polar die Wiederherstellung selbst: Es versucht die Karte erneut, hält das Abo in einem wiederherstellbaren Zustand und entzieht die Benefits, wenn nichts funktioniert. Die Regeln sind einfach und weitgehend fest, und das sollten Sie wissen, bevor Sie etwas darum herum gestalten.

Dieser Ratgeber erklärt den Ablauf Schritt für Schritt, die eine Einstellung, die Sie steuern, die Webhooks, auf die Sie hören sollten, und was Sie ergänzen können, ohne gegen den eigenen Ablauf von Polar zu arbeiten. Er hält sich an die Dokumentation von Polar: fehlgeschlagene Zahlungen zurückholen, wie Abos funktionieren, die Webhooks subscription.past_due und subscription.revoked (alle abgerufen im November 2026). Wo sich die Seiten von Polar widersprechen oder schweigen, sagen wir es.

Der Ablauf, Schritt für Schritt

Laut Seite zu fehlgeschlagenen Zahlungen von Polar:

1. Bei der Verlängerung setzt Polar das Abo zuerst auf den nächsten Abrechnungszyklus und versucht dann, die Standard-Zahlungsmethode des Kunden zu belasten.
2. Schlägt die Belastung fehl, wird das Abo nicht gekündigt. Es wechselt auf past_due und kommt in die automatisierte Zahlungswiederherstellung von Polar.
3. Polar versucht die Zahlung nach einem festen Plan erneut: vier Versuche, verteilt über 21 Tage, gerechnet ab dem ersten Fehlschlag. Der Plan wird von Polar festgelegt und ist nicht konfigurierbar.
4. Aktualisiert der Kunde zwischenzeitlich seine Zahlungsmethode, versucht Polar die Belastung sofort erneut, statt auf den nächsten geplanten Versuch zu warten.
5. Ist ein Retry erfolgreich, ist das Abo wieder in Ordnung.
6. Schlagen alle Retries fehl oder zeigt der Ablehnungscode, dass die Zahlungsmethode nie funktionieren wird (Polar nennt lost_card als Beispiel), stoppt Polar die Retries und entzieht das Abo und seine Benefits.

Punkt 6 ist bemerkenswert. Polar versucht eine Karte, die nicht funktionieren kann, nicht weiter, was das richtige Verhalten ist, und es bedeutet, dass Hard Declines viel früher als nach 21 Tagen enden, wenn der Kunde nicht handelt.

Die Einstellung, die Sie steuern: die Kulanzfrist

Standardmäßig entzieht Polar Benefits strikt. Polar bietet auf Organisationsebene eine Kulanzfrist (Grace Period), die den Entzug von Benefits aufschiebt, solange ein Abo past_due ist. Sie stellen sie unter Settings, dann Subscriptions, dann „Grace period for benefit revocation” ein.

Was die Kulanzfrist laut Doku von Polar tut und was nicht:

	Während der Kulanzfrist
Abo-Status	Weiterhin past_due
Benefits des Kunden	Bleiben erhalten
Retry-Plan	Unverändert
Gemessen ab	past_due_at

Die Kulanzfrist betrifft also den Zugang, nicht den Einzug. Sie ist eine gute Wahl, wenn Benefits Dinge sind, auf die sich Kunden täglich verlassen (ein Lizenzschlüssel, Zugang zu einem privaten Repository, eine Discord-Rolle), und ihr Verlust wegen eines vorübergehenden Kartenproblems den Kunden endgültig vertreiben würde.

Wie der Kunde es behebt

Die Lösung für die meisten Hard Declines ist eine neue Karte. Die Abo-Übersicht von Polar sagt, dass Kunden im Customer Portal ihre Zahlungsmethode aktualisieren, Rechnungen herunterladen und kündigen können. Da Polar nach einer Aktualisierung der Zahlungsmethode sofort erneut versucht, stellt ein Kunde, der seine Karte aktualisiert, das Abo sofort wieder her.

Die von uns geprüfte Doku von Polar beschreibt weder Inhalt noch Timing von E-Mails, die Kunden bei einem Fehlschlag erhalten. Testen Sie es in der Sandbox: Lösen Sie mit einer Testkarte einen Fehlschlag aus und sehen Sie, was im Postfach des Kunden ankommt, bevor Sie eigene Nachrichten schreiben, damit Sie keine Duplikate senden.

Die Webhooks, auf die Sie hören sollten

Event	Bedeutung
subscription.past_due	Eine Verlängerung ist fehlgeschlagen. Polar beschreibt das als wiederherstellbaren Zustand: Der Kunde kann seine Zahlungsmethode aktualisieren, um das Abo wiederherzustellen.
subscription.updated	Das Abo hat sich geändert, auch wenn es wiederhergestellt wird
subscription.revoked	Das Abo wurde entzogen, entweder weil es gekündigt wurde oder weil die Zahlungs-Retries ausgeschöpft sind

Eine Unstimmigkeit, die Sie einplanen sollten: Die Seite zu subscription.revoked von Polar sagt, dass der Status bei ausgeschöpften Zahlungs-Retries unpaid wird, während die Seite zu fehlgeschlagenen Zahlungen beschreibt, dass das Abo als gekündigt endet und die Benefits entzogen werden. Schreiben Sie Ihren Handler so, dass er beides als „zahlt nicht mehr” behandelt, und protokollieren Sie den tatsächlich empfangenen Status.

Eine praktische Einrichtung bei Polar

1. Über die Kulanzfrist entscheiden. Sind Benefits Teil der täglichen Arbeit, setzen Sie eine. Lassen sich Benefits leicht wiederherstellen, ist der strikte Entzug in Ordnung.
2. subscription.past_due in Ihrer App behandeln. Zeigen Sie ein Banner mit einem Link zum Customer Portal. Viele Kunden lesen nie Abrechnungsmails, aber sie sehen Ihr Produkt.
3. Erklären, was als Nächstes passiert. Sagen Sie dem Kunden, dass Polar es erneut versuchen wird und dass eine Kartenaktualisierung das Problem sofort löst.
4. Den Entzug angemessen behandeln. Bei subscription.revoked behalten Sie die Daten des Kunden, erklären, warum der Zugang endete, und bieten einen klaren Weg zurück.
5. Jeden Fehlschlag protokollieren. Speichern Sie Abo, Betrag, Datum und Ergebnis. Nach einigen Monaten sehen Sie, wie viele sich per Retry erholen und wie viele erst nach einer Kartenaktualisierung.
6. Mit Sandbox-Karten testen. Spielen Sie vor dem Livegang einen Soft Decline, einen Hard Decline und eine Wiederherstellung durch.

Wie der Zeitverlauf für einen Kunden aussieht

Fügt man die Regeln von Polar zusammen, läuft ein typischer Soft Decline so ab:

1. Verlängerungstag: Die Belastung schlägt fehl, das Abo wird past_due, und subscription.past_due erreicht Ihre App.
2. In den nächsten drei Wochen: Polar führt seine geplanten Retries durch. Haben Sie eine Kulanzfrist gesetzt, behält der Kunde so lange seine Benefits.
3. Jederzeit in diesem Fenster: Der Kunde aktualisiert seine Karte im Customer Portal, Polar versucht es sofort erneut, und das Abo wird wiederhergestellt.
4. Ende des Fensters ohne Erfolg: Polar entzieht das Abo, und subscription.revoked erreicht Ihre App.

Bei einem Hard Decline kann Schritt 2 ganz entfallen, weil Polar keine Retries für eine Zahlungsmethode macht, die nicht funktionieren kann. Deshalb zählt das Banner in der App bei Hard Declines am meisten: Die eigene Aktion des Kunden ist der einzige Weg zurück, und das Fenster ist kurz.

Was Polar nicht abdeckt

Die Wiederherstellung von Polar ist bewusst einfach. Was Ihnen bleibt:

• Kontext. Polar behandelt jeden Fehlschlag gleich. Ein Fehlschlag bei einem langjährigen Kunden, der das Produkt täglich nutzt, verdient eine andere Nachricht als einer bei einem ruhenden Account.
• Nachrichten in Ihrer eigenen Tonalität. Wollen Sie Recovery-Nachrichten, die Plan, Nutzung oder Team des Kunden erwähnen, schreiben Sie sie selbst.
• Messung. Zurückgeholt vs. verloren pro Monat und pro Ursache. Siehe unfreiwilliger Churn für die Definitionen und Vorlagen für Mahnmails für Ideen zu Nachrichten.
• Vorbeugung. Karten, die vor der nächsten Verlängerung ablaufen, sind vorhersehbar. Eine Erinnerung vor der Verlängerung vermeidet den Fehlschlag ganz; siehe ablaufende Karten.

So geht es mit NoChurn

Bei Polar bleiben Zahlungseinzug, Retries und der 21-Tage-Plan bei Polar als Merchant of Record; NoChurn ändert daran nichts. Es liest Ihre Polar-Abos und -Fehlschläge, sendet von der KI geschriebene Mahnmails, die Sie vor dem Versand prüfen, und gibt jedem Kunden einen Churn-Score von 0 bis 100, angereichert mit Ihren eigenen per API gesendeten Daten. Kündigungen bekommen dann einen Kündigungsflow und Win-back-Mails nach 30, 60 und 90 Tagen. Siehe NoChurn + Polar.