Alle Artikel
Tiefenanalyse7 Min. Lesezeit

Play Billing Library 8 ist jetzt für jedes Google-Play-Update Pflicht und verlagert das Erstattungs-Tracking auf Ihren Server

Googles Verlängerung für Play Billing Library 7 ist am 1. November 2026 ausgelaufen. Neue Apps und Updates brauchen jetzt Version 8 oder neuer. Version 8 hat queryPurchaseHistory() entfernt, deshalb müssen erstattete und verbrauchte Käufe serverseitig erfasst werden. Hier steht, was sich geändert hat und was eine langsame Migration kostet.

Der Schreibtisch eines Android-Entwicklers im Morgenlicht mit Laptop, Smartphone und einem Wandkalender mit eingekreistem Datum, in der Woche, in der Play Billing Library 8 zum Minimum für Google-Play-Updates wurde

Wichtigste Erkenntnisse

  • Googles Deprecation-Tabelle legte den 31. August 2026 als letzten Tag für neue Apps und Updates mit Play Billing Library 7 fest, Verlängerungen endeten am 1. November 2026. Jedes Google-Play-Update braucht jetzt Play Billing Library 8 oder neuer.
  • Apps, die bereits mit Play Billing Library 7 live sind, laufen weiter. Laut Google blockiert die Deprecation nur neue Apps und Updates, nicht bestehende Installationen.
  • Play Billing Library 8 hat queryPurchaseHistory() entfernt. Googles Ersatz ist serverseitig: verbrauchte Käufe im eigenen Backend erfassen und erstattete oder stornierte Käufe über die Voided Purchases API abrufen.
  • Die Google Play Voided Purchases API zeigt nur stornierte Käufe der letzten 30 Tage und erlaubt pro App 6.000 Abfragen pro Tag und 30 Abfragen in jedem 30-Sekunden-Zeitraum.
  • Google Play erstattet einen Kauf weiterhin automatisch und entzieht die Berechtigung, wenn die App ihn nicht innerhalb von drei Tagen bestätigt. Eine fehlerhafte Migration auf Play Billing Library 8 kann das bei jedem Verkauf auslösen.
  • Die Chargeback-Prüfung von Google Play ist der einzige Android-Erstattungsablauf, in dem der Entwickler Belege liefern kann, über orders.reviewrefund innerhalb von 24 Stunden nach der PendingRefundReviewNotification.
  • Bei Google-Play-Bestellungen ab dem 3. August 2026 trägt der Entwickler bei jedem verlorenen Chargeback den Kaufpreis abzüglich der Play-Servicegebühr sowie die Chargeback-Gebühren der Bank.

Jede Android-App, die über Google Play verkauft, muss mit ihrem nächsten Update Play Billing Library 8 oder neuer ausliefern. Die Frist von Version 7 für neue Apps und Updates war der 31. August 2026, die letzten Verlängerungen liefen am 1. November 2026 aus. Die Daten stehen in einer Tabelle in Googles Deprecation-FAQ, und die Erinnerungen kommen als Warnungen auf der Seite Richtlinienstatus in der Play Console.

Für die meisten Teams ist das ein Versionssprung bei einer Abhängigkeit und ein paar umbenannte Methoden. Bei Erstattungen ist es mehr. Play Billing Library 8 hat den einzigen Client-Aufruf gelöscht, mit dem eine App auf frühere Käufe zurückblicken konnte. Wer ab jetzt wissen will, was ein Nutzer gekauft, verbraucht oder erstattet bekommen hat, muss es auf dem eigenen Server festhalten.

Was die Frist für Play Billing Library 8 tatsächlich blockiert

Google gibt jeder Bibliotheksversion eine Lebensdauer von zwei Jahren. Die Deprecation stoppt nur neue Apps und Updates. Laut Googles FAQ funktionieren bestehende Apps weiter, und nicht gepflegte APKs brauchen keine Updates. Für eine App, die Sie nicht mehr anfassen, bricht heute also nichts. Es bricht an dem Tag, an dem Sie einen Fix, einen neuen Preis oder eine neue Paywall ausliefern wollen.

BibliotheksversionFrist für neue Apps und UpdatesFrist der Verlängerung
631. August 20251. November 2025
731. August 20261. November 2026
831. August 20271. November 2027
931. August 20281. November 2028

Version 8.0.0 erschien am 30. Juni 2025. Version 9.0.0 folgte am 19. Mai 2026. Wer jetzt migriert, gewinnt mit dem direkten Sprung auf 9 ein Jahr mehr als mit Version 8.

Warum Play Billing Library 8 für Erstattungen wichtig ist

Die wichtigste Streichung ist queryPurchaseHistory(). Die Methode wurde in Version 7 als veraltet markiert und in Version 8.0.0 entfernt. Googles Migrationshinweise teilen ihre alte Aufgabe in drei Teile, und nur einer davon bleibt auf dem Gerät.

Wofür Sie queryPurchaseHistory() genutzt habenWas Google jetzt empfiehltWo es läuft
Aktive und ausstehende KäufequeryPurchasesAsync()Auf dem Gerät
Verbrauchte EinmalkäufeIhre eigenen AufzeichnungenIhr Server
Erstattete, stornierte oder per Chargeback zurückgebuchte KäufeVoided Purchases APIIhr Server
Die vollständige Kaufhistorie eines NutzersIhre eigenen AufzeichnungenIhr Server

Kann ich verbrauchbare Käufe auf Android noch wiederherstellen?

Nicht vom Client aus. queryPurchasesAsync() liefert nur das, was aktiv ist. Ein verbrauchtes Credit-Paket oder ein aufgebrauchtes Edelstein-Bundle kommt darüber also nie zurück. Wenn ein Nutzer die App neu installiert und fragt, wo seine Münzen geblieben sind, muss die Antwort aus dem Ledger kommen, das Sie beim Kauf geführt haben. Apps, die sich auf die Kaufhistorie als kostenloses Backup verlassen haben, haben es verloren.

Wie erfahre ich jetzt von Erstattungen?

Über zwei serverseitige Kanäle. Real-time developer notifications senden eine VoidedPurchaseNotification mit dem Kauftoken, der Bestell-ID, dem Produkttyp und einem Erstattungstyp, der entweder eine volle Erstattung oder eine mengenbasierte Teilerstattung ist. Mit der Voided Purchases API rufen Sie dieselben Ereignisse nach Zeitraum ab, als Absicherung für alles, was Ihnen entgangen ist.

Die Pull-API hat harte Grenzen. Sie zeigt nur stornierte Käufe der letzten 30 Tage. Jede App bekommt 6.000 Abfragen pro Tag und 30 Abfragen in jedem 30-Sekunden-Zeitraum. Und eine Erstattung durch den Entwickler ohne die Option zum Widerruf wird gar nicht zurückgegeben. Ein Server, der fünf Wochen ausfällt, verliert Erstattungen, die er nie wieder abrufen kann.

Ein Techniker mit Tablet in einem ruhigen Servergang, wo erstattete und verbrauchte Google-Play-Käufe jetzt erfasst werden müssen, seit Play Billing Library 8 die clientseitige Kaufhistorie entfernt hat

Bei welchen Erstattungen der Entwickler noch mitreden kann

Das Erstattungs-Tracking auf den Server zu verlagern, gibt Ihnen keine zusätzliche Kontrolle über Erstattungen. Fast jede Erstattung bei Google Play wird ohne Sie entschieden: Self-Service-Erstattungen, Erstattungen durch den Support, Stornierungen und automatische Erstattungen bei nicht bestätigten Käufen. Sie erfahren davon erst im Nachhinein, über die Benachrichtigung zum stornierten Kauf.

Die Ausnahme ist die Chargeback-Prüfung. Wenn ein Käufer einen Chargeback einreicht, der Ihre Stellungnahme braucht, sendet Google eine PendingRefundReviewNotification. Laut Google sollten Sie innerhalb von 24 Stunden mit einer Erstattungsempfehlung und Nutzungsbelegen antworten, indem Sie orders.reviewrefund aufrufen. Diese Belege stammen aus denselben Serveraufzeichnungen, die Sie wegen der neuen Bibliothek ohnehin führen müssen. Ein Team, das ein Ledger für Wiederherstellungen führt, hat bereits alles, was es für die Antwort braucht.

Was eine langsame Migration in Geld kostet

Das direkte Risiko ist die Drei-Tage-Regel. Google Play erstattet einen Kauf automatisch und entzieht die Berechtigung, wenn Ihre App ihn nicht innerhalb von drei Tagen bestätigt. Bei ausstehenden Käufen beginnt die Frist, wenn der Kauf von PENDING zu PURCHASED wechselt. Eine Migration, die die Verbindungslogik, den neuen Listener für queryProductDetailsAsync() oder die Einrichtung ausstehender Käufe beschädigt, kann Bestätigungen stoppen, ohne die Verkäufe zu stoppen. Jede Bestellung in dieser Lücke wird voll erstattet, und der Nutzer hat bereits bekommen, wofür er bezahlt hat.

Genau da tut es weh. Ein erstattetes Bild-Credit-Paket hat die GPU-Zeit hinter jeder Generierung trotzdem verbraucht. Ein erstatteter KI-Tarif hat die kostenpflichtigen API-Aufrufe trotzdem ausgelöst. Eine erstattete Speicherstufe hat die Festplatten, die Sie bezahlen, trotzdem gefüllt. Ein erstattetes Trinkgeld ist trotzdem in eine Auszahlung an einen Creator geflossen. Die Erstattung gibt dem Käufer den Umsatz zurück und lässt diese Rechnungen bei Ihnen.

Auch Chargebacks sind teurer geworden. Laut Googles Hilfe trägt der Entwickler bei Bestellungen ab dem 3. August 2026 den Kaufpreis abzüglich der Play-Servicegebühr sowie die Chargeback-Gebühren der Bank. Google zahlt nur noch seine eigene Servicegebühr. Eine App, die eine Chargeback-Prüfung nicht innerhalb von 24 Stunden mit echten Nutzungsdaten beantworten kann, zahlt jedes Mal die ganze Rechnung.

Eine Migrations-Checkliste, die Umsatz schützt

  • Heben Sie die Abhängigkeit auf Play Billing Library 8 oder 9 an und entfernen Sie queryPurchaseHistory(), querySkuDetailsAsync() und das parameterlose enablePendingPurchases().
  • Aktualisieren Sie Ihren Listener für queryProductDetailsAsync(). Seit Version 8 liefert er auch Produkte, die nicht abgerufen werden konnten, mit einem Statuscode.
  • Aktivieren Sie enableAutoServiceReconnection(), damit eine abgebrochene Billing-Verbindung die Kaufverarbeitung nicht blockiert.
  • Rufen Sie queryPurchasesAsync() in onResume() auf, damit Käufe, die bei geschlossener App abgeschlossen werden, trotzdem innerhalb von drei Tagen bestätigt werden.
  • Protokollieren Sie jedes Kauftoken, jede Bestell-ID und jeden Verbrauch auf Ihrem Server, verknüpft mit Ihrer eigenen Konto-ID.
  • Abonnieren Sie Real-time developer notifications und verarbeiten Sie sowohl VoidedPurchaseNotification als auch PendingRefundReviewNotification.
  • Lassen Sie als Sicherheitsnetz einen täglichen Abgleich mit der Voided Purchases API laufen, deutlich innerhalb des 30-Tage-Fensters und des Tageskontingents von 6.000 Abfragen.

RefundHalt empfängt die Benachrichtigungen von Google Play zu stornierten Käufen und Chargeback-Prüfungen, beantwortet jede Prüfung über orders.reviewrefund innerhalb des 24-Stunden-Fensters mit Ihren echten Nutzungsdaten und bewahrt die Erstattungshistorie auf, die Ihre App nicht mehr vom Gerät abfragen kann.

Häufig gestellte Fragen

Muss ich jetzt Play Billing Library 8 verwenden?
Ja, für jede neue App und jedes Update, das über Google Play Billing verkauft. Googles Deprecation-Tabelle legte den 31. August 2026 als Frist für Version 7 fest, und die Verlängerungen endeten am 1. November 2026. Sie können Version 8 oder die neuere Version 9 verwenden.
Funktioniert meine bestehende App nicht mehr, wenn sie noch Play Billing Library 7 nutzt?
Doch, sie funktioniert weiter. Laut Google laufen bestehende Apps weiter, und nicht gepflegte APKs brauchen keine Updates. Die Deprecation hindert Sie nur daran, eine neue App oder ein Update mit einer nicht unterstützten Version zu veröffentlichen.
Was hat queryPurchaseHistoryAsync in Play Billing Library 8 ersetzt?
Auf dem Gerät übernimmt nichts dieselbe Aufgabe. Google empfiehlt queryPurchasesAsync() für aktive und ausstehende Käufe, die Erfassung verbrauchter Käufe auf Ihrem eigenen Server und die Voided Purchases API für stornierte oder erstattete Käufe.
Wie weit reicht die Google Play Voided Purchases API zurück?
30 Tage. Laut Google kann die API nur stornierte Käufe der letzten 30 Tage anzeigen, und sie begrenzt jede App auf 6.000 Abfragen pro Tag und 30 Abfragen in jedem 30-Sekunden-Zeitraum.
Erstattet Google Play einen Kauf, wenn meine App ihn nicht bestätigt?
Ja. Wird ein Kauf nicht innerhalb von drei Tagen bestätigt, erhält der Nutzer automatisch eine Erstattung, und Google Play widerruft den Kauf. Bei ausstehenden Käufen beginnen die drei Tage, wenn der Status von PENDING zu PURCHASED wechselt.

Quellen und weiterführende Informationen

RefundHalt

Der Rückerstattungs-Autopilot für App Store und Google Play

Weiterlesen

Die nächste Rückerstattungsanfrage ist bereits unterwegs.

Richten Sie RefundHalt in der Zeit ein, die Sie brauchen, um eine weitere Support-E-Mail über eine Rückerstattung zu lesen, die Sie nicht anfechten konnten.