Alle artikelen
Diepgaande analyse7 min leestijd

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.

Het bureau van een Android-ontwikkelaar in het ochtendlicht met een laptop, een telefoon en een wandkalender met een omcirkelde datum, in de week dat Play Billing Library 8 het minimum werd voor Google Play-updates

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.

BibliotheekversieDeadline nieuwe apps en updatesDeadline verlenging
631 augustus 20251 november 2025
731 augustus 20261 november 2026
831 augustus 20271 november 2027
931 augustus 20281 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() gebruikteWat Google nu adviseertWaar het draait
Actieve en openstaande aankopenqueryPurchasesAsync()Op het apparaat
Verbruikte eenmalige aankopenJe eigen administratieJe server
Terugbetaalde, geannuleerde of teruggeboekte aankopenVoided Purchases APIJe server
De volledige aankoopgeschiedenis van een gebruikerJe eigen administratieJe 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.

Een technicus met een tablet in een rustig gangpad van een serverruimte, waar terugbetaalde en verbruikte Google Play-aankopen nu moeten worden vastgelegd sinds Play Billing Library 8 de aankoopgeschiedenis op de client heeft verwijderd

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() en enablePendingPurchases() 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 in onResume(), 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 VoidedPurchaseNotification als PendingRefundReviewNotification.
  • 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

RefundHalt

De terugbetalingsautopiloot voor de App Store en Google Play

Lees verder

Het volgende terugbetalingsverzoek is al onderweg.

Stel RefundHalt in binnen de tijd die het kost om nog een supportmail te lezen over een terugbetaling die je niet kon betwisten.