Play Billing Library 8 is nu verplicht voor elke Google Play-update en verplaatst het bijhouden van terugbetalingen naar je server
De verlenging die Google gaf voor Play Billing Library 7 liep af op 1 november 2026. Nieuwe apps en updates hebben nu versie 8 of hoger nodig. Versie 8 heeft queryPurchaseHistory() verwijderd, dus terugbetaalde en verbruikte aankopen moeten op de server worden bijgehouden. Dit is wat er veranderd is en wat een trage migratie kost.

Belangrijkste inzichten
- De deprecation-tabel van Google noemde 31 augustus 2026 als laatste dag voor nieuwe apps en updates met Play Billing Library 7, en verlengingen eindigden op 1 november 2026. Elke Google Play-update heeft nu Play Billing Library 8 of hoger nodig.
- Apps die al live staan met Play Billing Library 7 blijven werken. Volgens Google blokkeert de deprecation alleen nieuwe apps en updates, geen bestaande installaties.
- Play Billing Library 8 heeft queryPurchaseHistory() verwijderd. De vervanging die Google voorstelt draait op de server: houd verbruikte aankopen bij in je eigen backend en haal terugbetaalde of geannuleerde aankopen op via de Voided Purchases API.
- De Google Play Voided Purchases API toont alleen ongeldig gemaakte aankopen van de afgelopen 30 dagen en staat per app 6.000 queries per dag en 30 queries per periode van 30 seconden toe.
- Google Play betaalt een aankoop nog steeds automatisch terug en trekt het recht in als de app de aankoop niet binnen drie dagen bevestigt. Een kapotte migratie naar Play Billing Library 8 kan dat bij elke verkoop veroorzaken.
- De chargebackbeoordeling van Google Play is de enige terugbetalingsflow op Android waarin de ontwikkelaar bewijs mag leveren, via orders.reviewrefund binnen 24 uur na de PendingRefundReviewNotification.
- Voor Google Play-bestellingen vanaf 3 augustus 2026 betaalt de ontwikkelaar bij elke verloren chargeback de aankoopprijs, min de servicekosten van Play, plus de chargebackkosten van de bank.
Elke Android-app die via Google Play verkoopt, moet bij de volgende update Play Billing Library 8 of hoger meeleveren. De deadline van versie 7 voor nieuwe apps en updates was 31 augustus 2026, en de laatste verlengingen liepen af op 1 november 2026. De datums staan in een tabel in de deprecation-FAQ van Google, en de herinneringen verschijnen als waarschuwingen op de pagina Beleidsstatus in Play Console.
Voor de meeste teams is het een nieuwe versie van een dependency en een paar hernoemde methoden. Voor terugbetalingen is het meer dan dat. Play Billing Library 8 heeft de enige clientaanroep verwijderd waarmee een app eerdere aankopen kon terugzien. Wil je vanaf nu weten wat een gebruiker heeft gekocht, verbruikt of terugbetaald gekregen, dan moet je server dat onthouden.
Wat de deadline voor Play Billing Library 8 echt blokkeert
Google geeft elke bibliotheekversie een levensduur van twee jaar. De deprecation stopt alleen nieuwe apps en updates. Volgens de FAQ van Google blijven bestaande apps werken en hoeven APK's die niet meer onderhouden worden geen updates. Voor een app waar je niet meer aankomt, gaat vandaag dus niets kapot. Het gaat kapot op de dag dat je een fix, een nieuwe prijs of een nieuwe paywall wilt uitbrengen.
| Bibliotheekversie | Deadline nieuwe apps en updates | Deadline verlenging |
|---|---|---|
| 6 | 31 augustus 2025 | 1 november 2025 |
| 7 | 31 augustus 2026 | 1 november 2026 |
| 8 | 31 augustus 2027 | 1 november 2027 |
| 9 | 31 augustus 2028 | 1 november 2028 |
Versie 8.0.0 verscheen op 30 juni 2025. Versie 9.0.0 volgde op 19 mei 2026. Migreer je nu, dan levert een directe overstap naar 9 je een jaar meer op dan stoppen bij 8.
Waarom Play Billing Library 8 belangrijk is voor terugbetalingen
De belangrijkste schrapping is queryPurchaseHistory(). De methode werd in versie 7 als verouderd gemarkeerd en in versie 8.0.0 verwijderd. De migratienotities van Google splitsen de oude taak in drie stukken, en maar een daarvan blijft op het apparaat.
| Waarvoor je queryPurchaseHistory() gebruikte | Wat Google nu adviseert | Waar het draait |
|---|---|---|
| Actieve en openstaande aankopen | queryPurchasesAsync() | Op het apparaat |
| Verbruikte eenmalige aankopen | Je eigen administratie | Je server |
| Terugbetaalde, geannuleerde of teruggeboekte aankopen | Voided Purchases API | Je server |
| De volledige aankoopgeschiedenis van een gebruiker | Je eigen administratie | Je server |
Kan ik verbruiksaankopen op Android nog herstellen?
Niet vanuit de client. queryPurchasesAsync() geeft terug wat actief is, dus een verbruikt creditpakket of een opgebruikte bundel edelstenen komt daar nooit meer langs. Installeert een gebruiker de app opnieuw en vraagt hij waar zijn munten zijn gebleven, dan moet het antwoord komen uit het grootboek dat je bijhield toen de aankoop plaatsvond. Apps die op de aankoopgeschiedenis leunden als gratis back-up, zijn die kwijt.
Hoe hoor ik nu van terugbetalingen?
Via twee kanalen op de server. Real-time developer notifications sturen een VoidedPurchaseNotification met het aankooptoken, de bestel-ID, het producttype en een terugbetalingstype dat een volledige terugbetaling is of een gedeeltelijke terugbetaling op basis van hoeveelheid. Met de Voided Purchases API haal je dezelfde gebeurtenissen op per tijdsperiode, als vangnet voor alles wat je hebt gemist.
De pull-API heeft harde grenzen. Hij toont alleen ongeldig gemaakte aankopen van de afgelopen 30 dagen. Elke app krijgt 6.000 queries per dag en 30 queries per periode van 30 seconden. En een terugbetaling door de ontwikkelaar zonder de optie om in te trekken komt er helemaal niet in terug. Een server die vijf weken plat ligt, verliest terugbetalingen die hij nooit meer kan ophalen.

Bij welke terugbetalingen de ontwikkelaar nog iets te zeggen heeft
Het bijhouden van terugbetalingen naar de server verplaatsen geeft je niet meer controle over terugbetalingen. Bijna elke terugbetaling in Google Play wordt zonder jou beslist: selfservice-terugbetalingen, terugbetalingen via support, annuleringen en automatische terugbetalingen bij onbevestigde aankopen. Je hoort er pas achteraf van, via de melding over de ongeldig gemaakte aankoop.
De uitzondering is de chargebackbeoordeling. Dient een koper een chargeback in waarvoor jouw input nodig is, dan stuurt Google een PendingRefundReviewNotification. Volgens Google moet je binnen 24 uur antwoorden met een terugbetalingsadvies en gebruiksbewijs, door orders.reviewrefund aan te roepen. Dat bewijs komt uit dezelfde serveradministratie die de nieuwe bibliotheek je toch al dwingt bij te houden. Een team dat een grootboek bijhoudt voor herstel, heeft al wat het nodig heeft om te antwoorden.
Wat een trage migratie kost in geld
Het directe risico is de drie-dagenregel. Google Play betaalt een aankoop automatisch terug en trekt het recht in als je app de aankoop niet binnen drie dagen bevestigt. Bij openstaande aankopen begint de klok te lopen zodra de aankoop van PENDING naar PURCHASED gaat. Een migratie die de verbindingslogica, de nieuwe listener van queryProductDetailsAsync() of de setup voor openstaande aankopen breekt, kan bevestigingen stoppen zonder de verkoop te stoppen. Elke bestelling in dat gat wordt volledig terugbetaald, en de gebruiker heeft al gekregen waarvoor hij betaalde.
Daar doet het pijn. Een terugbetaald creditpakket voor afbeeldingen heeft de GPU-tijd achter elke generatie toch verbruikt. Een terugbetaald AI-abonnement heeft de betaalde API-aanroepen toch gedaan. Een terugbetaald opslagniveau heeft de schijven waarvoor je betaalt toch gevuld. Een terugbetaalde fooi is toch uitbetaald aan een creator. De terugbetaling geeft de omzet terug aan de koper en laat die rekeningen bij jou.
Ook chargebacks zijn duurder geworden. Volgens het helpcentrum van Google betaalt de ontwikkelaar voor bestellingen vanaf 3 augustus 2026 de aankoopprijs, min de servicekosten van Play, plus de chargebackkosten van de bank. Google betaalt alleen nog zijn eigen servicekosten. Een app die een chargebackbeoordeling niet binnen 24 uur met echte gebruiksgegevens kan beantwoorden, betaalt elke keer die hele rekening.
Een migratiechecklist die je omzet beschermt
- Verhoog de dependency naar Play Billing Library 8 of 9 en verwijder
queryPurchaseHistory(),querySkuDetailsAsync()enenablePendingPurchases()zonder argumenten. - Werk je listener van
queryProductDetailsAsync()bij. Sinds versie 8 geeft hij ook producten terug die niet konden worden opgehaald, met een statuscode. - Zet
enableAutoServiceReconnection()aan, zodat een verbroken billingverbinding de verwerking van aankopen niet stillegt. - Roep
queryPurchasesAsync()aan inonResume(), zodat aankopen die worden afgerond terwijl de app dicht is, toch binnen drie dagen worden bevestigd. - Log elk aankooptoken, elke bestel-ID en elk verbruik op je server, gekoppeld aan je eigen account-ID.
- Abonneer je op Real-time developer notifications en verwerk zowel
VoidedPurchaseNotificationalsPendingRefundReviewNotification. - Draai als vangnet een dagelijkse synchronisatie met de Voided Purchases API, ruim binnen het venster van 30 dagen en het dagquotum van 6.000 queries.
RefundHalt luistert naar de meldingen van Google Play over ongeldig gemaakte aankopen en chargebackbeoordelingen, beantwoordt elke beoordeling via orders.reviewrefund binnen het venster van 24 uur met je echte gebruiksgegevens, en bewaart de terugbetalingsgeschiedenis die je app niet meer aan het apparaat kan vragen.
Veelgestelde vragen
- Moet ik nu Play Billing Library 8 gebruiken?
- Ja, voor elke nieuwe app of update die via Google Play-facturering verkoopt. De deprecation-tabel van Google noemde 31 augustus 2026 als deadline voor versie 7, en de verlengingen eindigden op 1 november 2026. Je kunt versie 8 gebruiken of de nieuwere versie 9.
- Stopt mijn bestaande app met werken als die nog Play Billing Library 7 gebruikt?
- Nee. Volgens Google blijven bestaande apps werken en hoeven APK's die niet meer onderhouden worden geen updates. De deprecation verhindert alleen dat je een nieuwe app of een update publiceert met een niet-ondersteunde versie.
- Wat vervangt queryPurchaseHistoryAsync in Play Billing Library 8?
- Niets op het apparaat doet hetzelfde werk. Google adviseert queryPurchasesAsync() voor actieve en openstaande aankopen, verbruikte aankopen bij te houden op je eigen server en de Voided Purchases API te gebruiken voor geannuleerde of terugbetaalde aankopen.
- Hoe ver terug gaat de Google Play Voided Purchases API?
- 30 dagen. Volgens Google kan de API alleen ongeldig gemaakte aankopen van de afgelopen 30 dagen tonen, en elke app is beperkt tot 6.000 queries per dag en 30 queries per periode van 30 seconden.
- Betaalt Google Play een aankoop terug als mijn app die niet bevestigt?
- Ja. Wordt een aankoop niet binnen drie dagen bevestigd, dan krijgt de gebruiker automatisch zijn geld terug en trekt Google Play de aankoop in. Bij openstaande aankopen beginnen de drie dagen zodra de status van PENDING naar PURCHASED gaat.
Bronnen en verder lezen
- 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
De terugbetalingsautopiloot voor de App Store en Google Play
Lees verder
Brazilië controleert nu welke games nog lootboxen aan kinderen verkopen, en bij terugbetalingen van lootboxen komt de rekening terecht
Het Braziliaanse ministerie van Justitie heeft de privacytoezichthouder gevraagd zes games te volgen die lootboxen verkopen zonder leeftijdscontrole. Dit eist de wet, dit eisen Apple en Google al, en zo bereken en behandel je terugbetalingen van lootboxen als de box al open is.
Onbedoelde in-app-aankopen zijn terugbetalingen die je niet kunt winnen. De oplossing hoort op je aankoopscherm
Onbedoelde in-app-aankopen komen in beide stores terug als terugbetalingen, en geen enkel gebruiksbewijs toont aan dat een tik bedoeld was. Zo labelen Apple en Google ze, dit kosten ze je aan rekenkracht en uitbetalingen, en met dit ontwerp van je aankoopscherm stop je ze voordat de afschrijving bestaat.