De rechten van je Google Play-serviceaccount bepalen wie je bestellingen kan terugbetalen, dus geef de smalste set die werkt
Eén Play Console-recht laat een serviceaccount elke bestelling terugbetalen en elk abonnement opzeggen. Dit zijn de rechten voor Google Play-serviceaccounts die refundtools echt nodig hebben, wat een gelekte sleutel in elke store kan doen en hoe je de sleutels afbakent, roteert en intrekt.

Belangrijkste inzichten
- Met het Google Play-recht Manage orders and subscriptions (bestellingen en abonnementen beheren) kan de houder bestellingen bekijken, bestellingen terugbetalen en abonnementen opzeggen, dus elk serviceaccount met dat recht kan geld teruggeven aan je kopers.
- Volgens de Play Developer API-gids van Google hebben de Google Play Billing API's twee Play Console-rechten nodig: View financial data, orders, and cancellation survey responses en Manage orders and subscriptions.
- De methode orders.refund van de Google Play Developer API kan elke bestelling van een eenmalige aankoop of abonnement tot 3 jaar oud terugbetalen, en met revoke op true eindigt de toegang van de koper direct.
- Sleutels van Google Cloud-serviceaccounts verlopen standaard niet, en Google zegt dat een sleutel die in een coderepository is beland in IAM moet worden verwijderd, omdat verwijderen uit de repository niet genoeg is.
- De In-App Purchase key van Apple kan geen terugbetalingen doen, maar kan wel de App Store Server API aanroepen, inclusief de endpoints die verlengingsdata van abonnementen tot 90 dagen opschuiven, een verlenging die volgens Apple niet kan worden teruggedraaid.
- Alleen een Account Holder of Admin kan in App Store Connect een In-App Purchase key aanmaken, de privésleutel kan maar één keer worden gedownload en een ingetrokken sleutel kan niet worden hersteld.
Geef één serviceaccount twee Play Console-rechten en het kan elke bestelling in je app terugbetalen. Dat is geen configuratiefout. Zo heeft Google de Google Play Developer API precies gebouwd, en daarom verdient de JSON-sleutel achter je refundtooling dezelfde zorg als de inlog van je bank.
De meeste teams stellen dit één keer in, onder tijdsdruk, door aan te vinken wat de eerste API-aanroep liet slagen. Deze gids gaat de andere kant op. Hij zet op een rij welke rechten voor Google Play-serviceaccounts werk met terugbetalingen en chargebacks echt nodig heeft, wat elke store een gestolen sleutel laat doen en hoe je de schade klein houdt.
Wat de rechten van een Google Play-serviceaccount echt toestaan
Een serviceaccount is een robotgebruiker. Je maakt het aan in Google Cloud en nodigt daarna het e-mailadres uit in Play Console onder Users and permissions (gebruikers en rechten), net zoals je een collega zou uitnodigen. Vanaf dat moment kan het alles doen wat die rechten toestaan, via de API, op elk uur, zonder tweede factor.
De twee rechten die de billing-API's vereisen
De Play Developer API-gids van Google is duidelijk. Om de Google Play Billing API's te gebruiken, geef je twee rechten: View financial data, orders, and cancellation survey responses (financiële gegevens, bestellingen en antwoorden op opzeggingsenquêtes bekijken) en Manage orders and subscriptions. Met het eerste kan het account bestellingen lezen en de Purchases API gebruiken. Het tweede is het recht dat aan geld komt.
| Play Console-recht | Wat het volgens Google toestaat | Kan het geld teruggeven aan kopers |
|---|---|---|
| View financial data, orders, and cancellation survey responses | Financiële rapporten, verkooprapporten en bestellingen bekijken, toegang tot de Purchases API, antwoorden op opzeggingsenquêtes downloaden | Nee |
| Manage orders and subscriptions | Bestellingen bekijken, bestellingen terugbetalen, abonnementen opzeggen | Ja |
| Admin (alle rechten) | Alle andere rechten, plus gebruikers uitnodigen en hun rechten wijzigen | Ja, en het kan zichzelf meer rechten geven |
Wat een sleutel met terugbetaalrechten kan doen
De methode orders.refund van de Google Play Developer API betaalt de abonnements- of in-app-aankoopbestelling van een gebruiker terug. Google zegt dat bestellingen ouder dan 3 jaar niet kunnen worden terugbetaald, wat betekent dat alles wat nieuwer is dat wel kan. Zet revoke op true en de toegang van de koper eindigt direct. Voor abonnementen doet purchases.subscriptionsv2.revoke met een volledige terugbetaling hetzelfde.
Dat zijn de juiste middelen als je ze bewust inzet. Google's eigen fraudeadvies zegt dat je een aankoop die je controles niet doorstaat moet terugbetalen en intrekken in plaats van te laten verlopen. Het probleem is een sleutel die dit kan voor elke app in je account terwijl hij er maar één nodig had.
Wat een gelekte sleutel je aan geld kan kosten
Reken het door voordat je bepaalt hoeveel moeite dit waard is. Op Google Play kan een sleutel met Manage orders and subscriptions bestellingen één aanroep tegelijk terugbetalen, en elke terugbetaling stuurt het aankoopbedrag terug naar de koper. Een script wordt niet moe. Het plafond is je bestelgeschiedenis van de afgelopen 3 jaar.
De kosten die niet terugkomen met de terugbetaling
Een terugbetaling draait de verkoop terug. Ze draait niet terug wat je hebt uitgegeven om die verkoop te leveren. Die uitgaven blijven in je boeken staan, of de terugbetaling nu de keuze van een klant was of van een aanvaller.
- Rekenkracht die je al hebt gebruikt: GPU- en servertijd achter elke generatie, render of modelrespons die de koper kreeg.
- API-aanroepen die je al hebt betaald: kosten per verzoek bij aanbieders van modellen, kaarten, spraak of data.
- Opslag waarvoor je blijft betalen: de bestanden en geschiedenis die die accounts nog op je servers hebben staan.
- Uitbetalingen die je al hebt gedaan: uitbetalingen aan makers, affiliates of verkopers die aan die aankopen gekoppeld zijn, komen niet terug met de terugbetaling.
Aan de kant van Apple ziet het er anders uit
De App Store Server API van Apple heeft geen endpoint dat een terugbetaling doet. Apple beslist over terugbetalingen. Maar dezelfde In-App Purchase key kan de verlengingsdatum van een abonnee tot 90 dagen opschuiven, twee keer per 365 dagen per klant, of voor alle actieve abonnees van een product in één massaverzoek. Apple zegt dat een verlenging niet kan worden teruggedraaid. Die dagen betaalt de abonnee niet en gebruikt hij je app gewoon, dus je rekeningen voor rekenkracht, opslag en API's lopen door zonder omzet.
| Wat een gestolen sleutel kan doen | Google Play-serviceaccount met Manage orders and subscriptions | Apple In-App Purchase key |
|---|---|---|
| Een bestelling terugbetalen | Ja, bestellingen tot 3 jaar oud | Nee, alleen Apple betaalt terug |
| De toegang van een koper beëindigen | Ja, met revoke bij terugbetaling | Nee |
| Abonnementen opzeggen of verlengen | Opzeggen, ja | Verlengingsdata tot 90 dagen opschuiven, onomkeerbaar |
| Aankoopgegevens lezen | Ja, met het bekijkrecht | Ja, transactie- en terugbetaalgeschiedenis |
| Reageren op terugbetaalbeoordelingen | Ja, orders.reviewrefund | Ja, Send Consumption Information |
| Beperken tot één app | Ja, via app-rechten | Nee, de sleutel werkt voor alle apps van je team |
Zo baken je de rechten van een Google Play-serviceaccount af
Play Console scheidt accountrechten van app-rechten. App-rechten gelden alleen voor de apps die je selecteert. Die ene instelling doet meer voor je veiligheid dan wat dan ook op deze lijst.
Geef rechten op één app, niet op het hele account
Nodig elk serviceaccount uit met app-rechten op alleen de apps die het bedient. Een refundtool voor één game heeft geen terugbetaalrechten nodig op je meditatie-app. Eén valkuil: View financial data, orders, and cancellation survey responses bestaat alleen op accountniveau, en de tegenhanger op app-niveau heet View financial data. Kies bij het afbakenen de variant op app-niveau.
Scheid lezen van terugbetalen
Niet elke taak heeft Manage orders and subscriptions nodig. Analytics die alleen bestellingen leest, kan draaien op een account met bekijkrechten en verder niets. Houd de sleutel met terugbetaalrechten bij de ene service die echt orders.refund, orders.reviewrefund of de revoke-endpoints aanroept.
Geef een robot nooit Admin
Admin geeft alle rechten, en Google noemt het uitnodigen van gebruikers en het beheren van hun rechten als onderdeel daarvan. Een gelekte Admin-sleutel kan zijn eigen toegang uitbreiden of iemand nieuw uitnodigen. Geen enkele terugbetaalworkflow heeft dat nodig.
Vraag leveranciers hoe ze verbinding maken
Sommige tools vragen je een JSON-sleutel te uploaden. Andere geven je het e-mailadres van hun eigen serviceaccount om uit te nodigen, zodat geen enkele sleutel van jou ooit buiten je controle komt en je hun toegang met één klik kunt intrekken in Users and permissions. Heeft een leverancier terugbetaalrechten nodig, vraag dan welke rechten, op welke apps en waarom.

Zo bewaar, roteer en trek je de sleutels in
Beide stores zeggen hetzelfde in andere woorden. Zet sleutels niet in een coderepository en lever ze niet mee in je app. De verschillen zitten in wat er gebeurt als er iets misgaat.
Google Cloud-sleutels verlopen niet vanzelf
De richtlijnen van Google Cloud merken op dat sleutels van serviceaccounts standaard geen vervaldatum hebben. Google raadt aan ze regelmatig te roteren en sleutels die je niet meer gebruikt uit te schakelen. Belandt een sleutel in een repository, dan zegt Google dat je hem zo snel mogelijk in IAM moet verwijderen, omdat verwijderen uit de repository niet genoeg is. Google Cloud kan gedetecteerde gelekte sleutels ook automatisch uitschakelen als de beperking Service Account Key Exposure Response op DISABLE_KEY staat, maar garandeert niet dat elk lek wordt opgemerkt.
Apple-sleutels download je één keer en trek je voorgoed in
Alleen een Account Holder of Admin kan een In-App Purchase key aanmaken. Apple bewaart de publieke helft, jij downloadt het privébestand .p8 één keer en Apple houdt geen kopie. Vermoed je dat een sleutel is gecompromitteerd, dan zegt Apple dat je hem direct moet intrekken in App Store Connect onder Users and Access, Integrations, In-App Purchase. Een ingetrokken sleutel kan niet worden hersteld, en intrekken stopt ook het inwisselen van promotieaanbiedingen die ermee zijn ondertekend, dus werk die aanbiedingen bij vóór of direct na het intrekken.
| Taak | Google Play-serviceaccount | Apple In-App Purchase key |
|---|---|---|
| Wie kan het aanmaken | Aangemaakt in Google Cloud, daarna uitgenodigd in Play Console via Users and permissions | Account Holder of Admin |
| Kun je het geheim opnieuw downloaden | Je maakt een nieuwe sleutel aan | Nee, maar één download |
| Standaard vervaldatum | Geen | Geen, tot je hem intrekt |
| Hoe je toegang snel afsluit | Verwijder de sleutel in IAM, of verwijder het account in Play Console | Trek de sleutel in in App Store Connect |
| Bijwerkingen van toegang afsluiten | Elke tool die dat account gebruikt, roept de API niet meer aan | Promotieaanbiedingen die ermee zijn ondertekend, worden niet meer ingewisseld |
Een korte checklist
- Eén serviceaccount per taak, uitgenodigd met app-rechten op alleen de apps die het bedient.
- Manage orders and subscriptions alleen op het account dat echt terugbetaalt, intrekt of reageert op beoordelingen.
- Geen Admin op welk robotaccount dan ook.
- Sleutels in een secret manager, nooit in een repository, een buildlog of een mobiele app.
- Een geschreven lijst van elke sleutel, wie hem heeft aangemaakt en welke service hem gebruikt, zodat een intrekking je terugbetaalantwoorden niet breekt.
- Een controle van Users and permissions in Play Console en de sleutels in App Store Connect telkens wanneer iemand het team verlaat of een leverancier wordt geschrapt.
Veelgestelde vragen
- Welke Play Console-rechten heeft een serviceaccount nodig voor terugbetalingen en chargebacks?
- Het heeft Manage orders and subscriptions nodig om bestellingen terug te betalen, abonnementen op te zeggen en met bestellingen te werken, plus bekijkrechten op bestellingen. De Play Developer API-gids van Google noemt View financial data, orders, and cancellation survey responses en Manage orders and subscriptions als de twee rechten die de Google Play Billing API's vereisen.
- Kan een Google Play-serviceaccount bestellingen terugbetalen?
- Ja, als het het recht Manage orders and subscriptions heeft. Volgens de helppagina van Google kunnen gebruikers met dat recht bestellingen bekijken, bestellingen terugbetalen en abonnementen opzeggen, en de API-methode orders.refund betaalt elke bestelling tot 3 jaar oud terug.
- Kan iemand met mijn App Store In-App Purchase key mijn klanten terugbetalen?
- Nee. De App Store Server API heeft geen endpoint voor terugbetalingen, omdat Apple over terugbetalingen beslist. Een gestolen sleutel kan nog wel transactie- en terugbetaalgeschiedenis lezen, verbruiksinformatie sturen en verlengingsdata van abonnementen tot 90 dagen opschuiven, wat volgens Apple niet kan worden teruggedraaid.
- Verlopen sleutels van Google Play-serviceaccounts?
- Standaard niet. Volgens de richtlijnen van Google Cloud hebben sleutels die je aanmaakt en downloadt geen vervaldatum tenzij je er een instelt, en Google raadt aan sleutels regelmatig te roteren en de sleutels die je niet meer gebruikt uit te schakelen.
- Wat moet ik doen als de JSON-sleutel van mijn serviceaccount op GitHub is gezet?
- Verwijder de sleutel direct in Google Cloud IAM en maak een nieuwe aan. Google zegt dat de sleutel uit de repository halen niet genoeg is, omdat iedereen die hem heeft gekopieerd hem kan blijven gebruiken totdat de sleutel zelf is verwijderd.
Bronnen en verder lezen
- Play Console Help: Add developer account users and manage permissions
- Google Play Developer API: Getting started (service accounts and required permissions)
- Google Play Developer API: orders.refund reference
- Android Developers: Fight fraud and abuse
- Google Cloud: Best practices for managing service account keys
- Apple Developer: Creating API keys to authorize API requests
- App Store Connect Help: Generate keys for in-app purchases
- Apple Developer: Extending the renewal date for auto-renewable subscriptions
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.