FEHLGESCHLAGENE ZAHLUNGENGOOGLE PLAY

So senken Sie Churn auf Google Play: Grace Period und Account Hold

Wie Grace Period und Account Hold bei Google Play funktionieren, welche Echtzeit-Benachrichtigungen zählen, In-App-Nachrichten bei Ablehnungen und Win-back.

Veröffentlicht am 7 Min. Lesezeit

Bei Google Play belastet Google den Kunden, wiederholt fehlgeschlagene Zahlungen und zeigt den Kündigungsbutton. Sie können keine Belastung wiederholen und die Zahlungsmethode des Kunden nicht anfassen. Was Sie steuern: wie lange Grace Period und Account Hold dauern, ob der Kunde Zugang behält, was Ihre App ihm zeigt und wie schnell Sie reagieren, wenn sich ein Abo erholt oder endet.

Dieser Ratgeber behandelt die Grace Period, den Account Hold, die Echtzeit-Entwicklerbenachrichtigungen (Real-time Developer Notifications, RTDN) und die zugrunde liegenden subscriptionsv2-Status, In-App-Nachrichten bei Zahlungsablehnungen, Deep Links zum Abo-Center, Wiederherstellen und erneutes Abonnieren sowie stornierte Käufe. Er hält sich an die Dokumentation von Google: Lebenszyklus von Abos, über Abos, die RTDN-Referenz und Google beim Anfechten von Chargebacks helfen (alle abgerufen im November 2026).

Was Google tut, wenn eine Verlängerung fehlschlägt

Wenn eine Verlängerungszahlung fehlschlägt, benachrichtigt Google den Nutzer und versucht eine Zeit lang weiter zu verlängern, bevor das Abo endet. Die Doku von Google nennt das die Wiederherstellungsphase, bestehend aus einer Grace Period (Kulanzfrist), gefolgt von einem Account Hold (Kontosperre). Währenddessen sendet Google dem Nutzer E-Mails und Benachrichtigungen mit der Bitte, seine Zahlungsmethode zu aktualisieren.

Phase Zugang des Nutzers subscriptionState RTDN bei Beginn
Grace Period Behält den Zugang SUBSCRIPTION_STATE_IN_GRACE_PERIOD SUBSCRIPTION_IN_GRACE_PERIOD (6)
Account Hold Verliert den Zugang SUBSCRIPTION_STATE_ON_HOLD SUBSCRIPTION_ON_HOLD (5)
Erholt Zugang wiederhergestellt SUBSCRIPTION_STATE_ACTIVE SUBSCRIPTION_RECOVERED (1)
Nicht erholt Zugang beendet SUBSCRIPTION_STATE_CANCELED, dann EXPIRED SUBSCRIPTION_CANCELED (3), dann SUBSCRIPTION_EXPIRED (13)

Grace Period

Der Lebenszyklus-Leitfaden von Google sagt:

  • Die Grace Period ist bei allen sich automatisch verlängernden Basisplänen standardmäßig aktiviert. Sie können ihre Dauer ändern oder sie in der Play Console abschalten, und Google warnt, dass eine kürzere Dauer die Zahl der zurückgewonnenen Abos verringern kann.
  • Während der Grace Period sollte der Nutzer Zugang behalten. autoRenewEnabled bleibt true, und Google verlängert expiryTime bis zum Ende der Grace Period.
  • Wenn der Nutzer seine Zahlungsmethode in Ordnung bringt, verlängert sich das Abo mit seinem ursprünglichen Verlängerungsdatum.
  • Eine Änderung der Dauer der Grace Period betrifft nur Verlängerungen, die nach der Änderung in die Grace Period eintreten.
  • Wenn Sie 0 Tage einstellen, wartet Google trotzdem mindestens 1 Tag (eine „stille Grace Period“), um Zeit für Wiederholungen zu lassen. Das Abo bleibt in diesen 24 Stunden aktiv, und Sie erhalten keine RTDN zur Grace Period.

Wenn Ihre App nur queryPurchasesAsync() nutzt, um die Berechtigung zu prüfen, werden Grace Periods für Sie behandelt, weil die Play Billing Library diese Käufe weiterhin als aktiv zurückgibt.

Account Hold

Der Account Hold folgt auf die Grace Period:

  • Er ist standardmäßig aktiviert, und seine Standarddauer beträgt 60 Tage minus die Grace Period. Sie können ihn in der Play Console ändern oder abschalten, mit derselben Warnung zu kürzeren Dauern.
  • Bevor das Abo in den Account Hold geht, unternimmt Google bis zu 48 Stunden lang zusätzliche Belastungsversuche, während der Nutzer Zugang behält.
  • Während des Account Hold sollten Sie den Zugang sperren. expiryTime liegt in der Vergangenheit, und queryPurchasesAsync() gibt das Abo nicht mehr zurück.
  • Wenn der Nutzer seine Zahlung in Ordnung bringt, erhalten Sie SUBSCRIPTION_RECOVERED, das Purchase Token bleibt gleich, und Sie müssen den Zugang wiederherstellen. Anders als bei einer Erholung während der Grace Period verschiebt sich das Abrechnungsdatum auf das Datum der Erholung.
  • Wenn der Hold ohne Lösung endet, erhalten Sie SUBSCRIPTION_CANCELED und dann SUBSCRIPTION_EXPIRED.
  • Ein pausiertes Abo, das mit einer nicht funktionierenden Zahlungsmethode fortgesetzt wird, geht direkt in den Account Hold.

Google weist außerdem darauf hin, dass Nutzer während des Hold kündigen, wiederherstellen oder erneut kaufen können; Ihr Backend muss diese Events also weiterhin verarbeiten.

Echtzeit-Entwicklerbenachrichtigungen

RTDNs werden über Cloud Pub/Sub zugestellt und enthalten nur den Benachrichtigungstyp und das Purchase Token. Googles Empfehlung ist, bei jeder Benachrichtigung aus Ihrem Backend purchases.subscriptionsv2.get aufzurufen, um den vollständigen Status zu lesen. Die RTDN-Referenz listet die Abo-Typen auf; die für Churn wichtigsten:

Code Typ Was zu tun ist
6 SUBSCRIPTION_IN_GRACE_PERIOD Zugang behalten; den Nutzer bitten, seine Zahlung in Ordnung zu bringen
5 SUBSCRIPTION_ON_HOLD Zugang entziehen; dem Nutzer sagen, warum
1 SUBSCRIPTION_RECOVERED Zugang wiederherstellen (wird auch gesendet, wenn ein Abo aus einer Pause fortgesetzt wird)
2 SUBSCRIPTION_RENEWED Normale Verlängerung
3 SUBSCRIPTION_CANCELED Freiwillige oder unfreiwillige Kündigung; canceledStateContext prüfen
7 SUBSCRIPTION_RESTARTED Der Nutzer hat ein gekündigtes, noch nicht abgelaufenes Abo wiederhergestellt
12 SUBSCRIPTION_REVOKED Vor Ablauf widerrufen, zum Beispiel nach einem Chargeback; Zugang entziehen
13 SUBSCRIPTION_EXPIRED Zugang entziehen
4 SUBSCRIPTION_PURCHASED Neuer Kauf, einschließlich eines erneuten Abonnierens

Bei einer Kündigung sagt Ihnen canceledStateContext, ob der Nutzer, das System oder Sie gekündigt haben, und bei Kündigungen durch den Nutzer kann userInitiatedCancellation den Grund enthalten, den der Nutzer angegeben hat. Nutzen Sie ihn: Eine Kündigung nach einem Account Hold ist ein Zahlungsproblem, keine Entscheidung zu gehen.

In-App-Nachrichten bei Zahlungsablehnungen

Google bietet eine fertige Nachricht für Zahlungsprobleme an. Wenn Sie BillingClient.showInAppMessages() mit InAppMessageCategoryId.TRANSACTIONAL aufrufen, zeigt Google Play eine vorübergehende Snackbar, die dem Nutzer sagt, dass seine Zahlung abgelehnt wurde, mit einem Deep Link, um seine Zahlungsmethode bei Google Play in Ordnung zu bringen. Laut dem Abo-Leitfaden von Google wird die Nachricht während der Grace Period und des Account Hold einmal pro Tag angezeigt, und Google empfiehlt, die API bei jedem Öffnen der App aufzurufen.

Wenn der Nutzer seine Zahlung in Ordnung bringt, gibt der Aufruf SUBSCRIPTION_STATUS_UPDATED mit einem Purchase Token zurück. Aktualisieren Sie das Abo aus Ihrem Backend und stellen Sie den Zugang sofort wieder her.

Für Nutzer, die Ihre Inhalte außerhalb der App erreichen (zum Beispiel im Web), empfiehlt Google eine Push-Benachrichtigung oder eine E-Mail, wenn der Zugang wegen eines Account Hold endet.

Ihre App sollte von ihrem Einstellungsscreen auf die Abo-Verwaltung verlinken. Google dokumentiert zwei URLs:

  1. Alle Abos: https://play.google.com/store/account/subscriptions
  2. Ein bestimmtes Abo (empfohlen): https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package

Die zweite öffnet die Verwaltungsseite dieses Abos, auf der der Nutzer seine Zahlungsmethoden verwalten, kündigen, erneut abonnieren oder pausieren kann. Nutzen Sie sie auch in Ihren eigenen Zahlungs-E-Mails.

Wiederherstellen, erneut abonnieren und Win-back

Google unterscheidet zwei Aktionen, die dem Nutzer im Play Store beide als Button Resubscribe angezeigt werden:

  • Wiederherstellen (Restore): Vor Ablauf wird ein gekündigtes Abo wiederhergestellt und verlängert sich weiter, als wäre es nie gekündigt worden. Es behält dasselbe Purchase Token, und Sie erhalten SUBSCRIPTION_RESTARTED. Google sagt, dass alle Apps das Wiederherstellen unterstützen müssen.
  • Erneut abonnieren (Resubscribe): Nach Ablauf kauft der Nutzer, sofern der Basisplan es erlaubt, erneut im Play Store. Das ist ein neuer Kauf mit einem neuen Token und einer RTDN SUBSCRIPTION_PURCHASED. Sie müssen ihn bestätigen (acknowledge); das Feld outOfAppPurchaseContext hilft Ihnen, ihn dem vorherigen Abo und Nutzer zuzuordnen.

Innerhalb Ihrer App beschreibt Googles Leitfaden, wie Sie Nutzer zurückgewinnen, die gekündigt haben, indem Sie einen Screen zur erneuten Anmeldung anbieten (zum Beispiel mit einem Button Reaktivieren), vor oder nach dem Ablauf. Abo-Angebote können berechtigte Nutzer mit Rabatten ansprechen; die Berechtigungsregeln werden in der Play Console festgelegt.

Erstattungen, stornierte Käufe und Chargebacks

Wenn ein Kauf erstattet oder per Chargeback zurückgebucht wird, wird er storniert (voided). Sie erhalten eine RTDN voidedPurchaseNotification mit dem Purchase Token, der Bestell-ID, productType und refundType (volle Erstattung oder mengenbasierte Teilerstattung). Der Lebenszyklus-Leitfaden von Google ergänzt, dass ein per Chargeback zurückgebuchtes oder von Ihrem Backend mit purchases.subscriptionsv2.revoke widerrufenes Abo SUBSCRIPTION_REVOKED auslöst, und Sie sollten den Zugang entziehen. Die Voided Purchases API gibt Ihnen mehr Details über einen Zeitraum.

Bei Chargebacks lässt Google Sie mitreden. Wenn ein Chargeback eine Prüfung durch den Entwickler erfordert, sendet Google Play eine RTDN PendingRefundReviewNotification, und Sie haben 24 Stunden, um mit der ReviewRefund API zu antworten, mit einer Präferenz zur Erstattung und etwaigen Nachweisen zur Nutzung des Kaufs. Google berücksichtigt nur Ihren ersten Aufruf.

Eine Checkliste

  • RTDNs werden an Ihr Backend zugestellt, und jede löst ein subscriptionsv2.get aus.
  • Grace Period und Account Hold sind aktiviert, mit bewusst gewählten Dauern.
  • Der Zugang bleibt während der Grace Period bestehen und endet während des Account Hold.
  • showInAppMessages() wird beim Start der App aufgerufen.
  • Ihr Einstellungsscreen und Ihre E-Mails verwenden den Deep Link zum bestimmten Abo.
  • Käufe aus Wiederherstellen und erneutem Abonnieren werden verarbeitet und bestätigt.
  • Jeder Kauf trägt eine verschleierte Konto-ID (obfuscated account ID), damit Sie ihn Ihrem Nutzer zuordnen können.
  • Stornierte Käufe und Benachrichtigungen zur Chargeback-Prüfung werden verarbeitet.

Das mit NoChurn umsetzen

Google behält Zahlungen, Wiederholungen, Grace Period, Account Hold und den Kündigungsbutton; NoChurn ändert daran nichts. NoChurn liest Ihre Echtzeit-Entwicklerbenachrichtigungen, ordnet jedes Abo über die verschleierte Konto-ID Ihrem Nutzer zu und legt Grace Periods, Holds, Kündigungen, Erholungen und stornierte Käufe in die Zeitleiste des Kunden und in einen Churn-Score von 0 bis 100. Wo Google es erlaubt, handelt es: Nachrichten in Ihrer App oder per E-Mail, die auf die Abo-Seite von Play verlinken, ein Kündigungsflow, den Ihre App über die Headless-API anzeigt, bevor sie auf Google Play verlinkt, und Win-back-E-Mails an Tag 30, 60 und 90 je nach Kündigungsgrund. Siehe NoChurn + Google Play.

PROMPT

Read https://www.nochurn.sh/llms.txt,
then follow https://www.nochurn.sh/docs/quickstart/
to add NoChurn to this app. Use a test key
(nc_test_…) until I say we go live.

Hören Sie auf, Umsatz zu verlieren.

  • Kostenlos bis $300 MRR
  • Keine Karte nötig
  • In 10 Minuten live
  • Nie ein Anteil an dem, was wir retten