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.

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.
| Bibliotheksversion | Frist für neue Apps und Updates | Frist der Verlängerung |
|---|---|---|
| 6 | 31. August 2025 | 1. November 2025 |
| 7 | 31. August 2026 | 1. November 2026 |
| 8 | 31. August 2027 | 1. November 2027 |
| 9 | 31. August 2028 | 1. 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 haben | Was Google jetzt empfiehlt | Wo es läuft |
|---|---|---|
| Aktive und ausstehende Käufe | queryPurchasesAsync() | Auf dem Gerät |
| Verbrauchte Einmalkäufe | Ihre eigenen Aufzeichnungen | Ihr Server |
| Erstattete, stornierte oder per Chargeback zurückgebuchte Käufe | Voided Purchases API | Ihr Server |
| Die vollständige Kaufhistorie eines Nutzers | Ihre eigenen Aufzeichnungen | Ihr 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.

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 parameterloseenablePendingPurchases(). - 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()inonResume()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
VoidedPurchaseNotificationals auchPendingRefundReviewNotification. - 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
- Android Developers: Play Billing Library deprecation FAQ
- Android Developers: Play Billing Library release notes
- Android Developers: Migrate to Play Billing Library 8
- Android Developers: Query purchase history alternatives
- Android Developers: Integrate the Google Play Billing Library into your app
- Android Developers: Real-time developer notifications reference
- Google Play Developer API: Voided Purchases API
- Play Console Help: Chargeback cost sharing for orders after August 3, 2026
RefundHalt
Der Rückerstattungs-Autopilot für App Store und Google Play
Weiterlesen
Brasilien prüft jetzt, welche Spiele noch Lootboxen an Kinder verkaufen, und bei Lootbox-Erstattungen landet die Rechnung
Das brasilianische Justizministerium hat die Datenschutzbehörde gebeten, sechs Spiele zu überwachen, die Lootboxen ohne Altersprüfung verkaufen. Was das Gesetz verlangt, was Apple und Google schon fordern und wie Sie Lootbox-Erstattungen kalkulieren und abwickeln, wenn die Box bereits geöffnet ist.
Versehentliche In-App-Käufe sind Erstattungen, die Sie nicht gewinnen können. Die Lösung gehört auf Ihren Kaufbildschirm
Versehentliche In-App-Käufe kommen in beiden Stores als Erstattungen zurück, und keine Nutzungsdaten beweisen, dass ein Tippen gewollt war. So kennzeichnen Apple und Google diese Fälle, das kosten sie Sie an Rechenleistung und Auszahlungen, und mit diesem Kaufbildschirm-Design stoppen Sie sie, bevor die Belastung entsteht.