SubmetryBlog

App-Store-Abos: Billing Grace Period und Billing Retry richtig unterscheiden

So trennst du nach einer fehlgeschlagenen Verlängerung Zahlung, Zugriffsrecht und Ausgang des Falls und prüfst den Ablauf in Apples Sandbox.

Eine gläserne Sanduhr neben einer unbeschrifteten Zahlungskarte. Leuchtende Pfade führen zu einem Wiederholungszeichen und einem Häkchen.

Wenn die Verlängerung eines App-Store-Abos fehlschlägt, beantworten Zahlung und Zugriff zwei verschiedene Fragen. Hat Apple den Betrag beim nächsten Versuch einziehen können? Und durfte die Person in der Zwischenzeit die Abo-Funktionen nutzen? Wer beides als einen Status speichert, kann zahlende Kunden zu früh aussperren oder einen noch offenen Fall als zurückgewonnenes Abo zählen.

1. Zahlungsversuch und Zugriffsrecht getrennt erfassen

Billing Retry bedeutet, dass der App Store nach einer fehlgeschlagenen automatischen Verlängerung weitere Einzugsversuche unternimmt. Eine Billing Grace Period ist hingegen eine in App Store Connect konfigurierbare Kulanzfrist. Gilt sie für das betreffende Abo, bleibt der Zugriff während dieser Frist erhalten, obwohl die Verlängerungszahlung noch nicht bestätigt ist. Endet die Frist ohne Erfolg, kann der Zugriff ablaufen, obwohl Apple die Zahlung weiter versucht. Die Apple-Anleitung zur Kulanzfrist erklärt die Konfiguration und die nötige Statusprüfung.

Ein Beispiel: Am Montag scheitert die Zahlung, der Zugriff bleibt zunächst bestehen. Nach Fristende wird er entzogen, später gelingt die Zahlung. Das ist eine nachträglich erfolgreiche Verlängerung mit Zugriffsunterbrechung, nicht dasselbe wie eine erfolgreiche Abbuchung während der Kulanzfrist. Erfasse deshalb die Zeitpunkte für den ersten Fehler, das Ende der Kulanzfrist, den tatsächlichen Zugriffswechsel und die bestätigte Verlängerung getrennt.

2. Webhooks als Auslöser, nicht als alleinigen Zustand behandeln

RevenueCat beschreibt für Abrechnungsfehler unter anderem BILLING_ISSUE und CANCELLATION mit dem Grund BILLING_ERROR. Letzteres ist nicht automatisch eine freiwillige Kündigung. Ob und wann ein Zugriffsrecht endet, hängt vom bestätigten Zustand ab, nicht davon, welche Nachricht zuletzt im System angekommen ist. Die dokumentierten RevenueCat-Webhook-Abläufe zeigen Beispiele und weisen auf mögliche Abweichungen bei Reihenfolge und Zeitstempeln hin.

Lege eine verifizierte Statusquelle fest und nutze eingehende Ereignisse, um sie abzugleichen. Speichere Ereignis-ID, Abo-Bezug, relevanten Zeitstempel und Empfangszeit. Wiederholte Zustellungen sollen denselben Eintrag nicht doppelt verbuchen. Ein verspätetes Ereignis darf einen bereits bestätigten neueren Zustand nicht überschreiben. Prüfe bei widersprüchlichen Informationen den aktuellen Status erneut, statt aus einem einzelnen Webhook auf Zahlung oder Zugriff zu schließen.

3. Drei Fälle in Apples Sandbox nachspielen

Simuliere eine fehlgeschlagene Verlängerung in der Apple-Sandbox. Teste eine erfolgreiche Zahlung während der Kulanzfrist, eine Zahlung erst nach Ende des Zugriffs und einen Fall ohne erfolgreiche Zahlung im Beobachtungsfenster. Die StoreKit-Anleitung zum Testen fehlgeschlagener Verlängerungen beschreibt das Vorgehen. Sandbox-Zeiten sind keine Vorhersage für die Produktionsumgebung.

Prüfe für jeden Fall, was ein Nutzer in der App sieht und was dein Backend speichert. Spiele zusätzlich eine doppelte und eine verspätete Nachricht ein. Endzustand, Zugriffsverlauf und Auswertung sollen dabei konsistent bleiben.

4. Nur vergleichbare Fälle auswerten

Bilde Kohorten nach dem Datum der ersten fehlgeschlagenen Verlängerung. Zähle einen Fall einmal pro betroffenem Verlängerungsvorgang, nicht pro Zustellversuch. Vergleiche nur Kohorten mit vollständig abgelaufenem, vorab festgelegtem Beobachtungsfenster. Fälle, die dieses Alter noch nicht erreicht haben, bleiben offen.

Trenne bei der Auswertung Verlängerungen ohne Unterbrechung, Verlängerungen nach einer Zugriffslücke und Fälle ohne bestätigte Verlängerung im gewählten Fenster. So beantwortest du sowohl die Frage nach der Zahlung als auch die Frage nach dem Kundenerlebnis. Eine höhere Rückgewinnungsquote beweist für sich allein nicht, dass die Kulanzfrist die Ursache war.

Den Unterschied zwischen Kündigung und Ablauf erklärt der Submetry-Leitfaden zur Abwanderungsrate.

Submetry kennenlernen und sich auf die Warteliste setzen.