I permessi dell'account di servizio Google Play decidono chi può rimborsare i tuoi ordini, quindi concedi il minimo indispensabile
Un solo permesso di Play Console consente a un account di servizio di rimborsare qualsiasi ordine e annullare qualsiasi abbonamento. Ecco quali permessi dell'account di servizio Google Play servono davvero a uno strumento di rimborso, cosa può fare una chiave trapelata su ciascuno store e come limitare, ruotare e revocare le chiavi.

Punti chiave
- Il permesso Manage orders and subscriptions (gestire ordini e abbonamenti) di Google Play consente di visualizzare ordini, rimborsarli e annullare abbonamenti, quindi qualsiasi account di servizio che lo possiede può restituire denaro ai tuoi acquirenti.
- La guida di Google Play Developer API indica che le API di fatturazione di Google Play richiedono due permessi di Play Console: View financial data, orders, and cancellation survey responses, e Manage orders and subscriptions.
- Il metodo orders.refund di Google Play Developer API può rimborsare qualsiasi ordine di acquisto singolo o di abbonamento fino a 3 anni di anzianità e, con revoke impostato su true, chiude subito l'accesso dell'acquirente.
- Le chiavi degli account di servizio Google Cloud non scadono per impostazione predefinita, e Google afferma che una chiave finita in un repository di codice va eliminata in IAM, perché toglierla dal repository non basta.
- La In-App Purchase key di Apple non può emettere rimborsi, ma può chiamare App Store Server API, compresi gli endpoint che posticipano la data di rinnovo di un abbonamento fino a 90 giorni, un'estensione che secondo Apple non si può annullare.
- Solo un Account Holder o un Admin può generare una In-App Purchase key in App Store Connect, la chiave privata si scarica una sola volta e una chiave revocata non può essere ripristinata.
Dai a un account di servizio due permessi di Play Console e potrà rimborsare qualsiasi ordine della tua app. Non è un errore di configurazione. È esattamente così che Google ha progettato Google Play Developer API, ed è per questo che la chiave JSON dietro il tuo strumento di rimborso merita la stessa cura delle credenziali della tua banca.
La maggior parte dei team lo configura una volta, sotto scadenza, spuntando tutto ciò che ha fatto andare a buon fine la prima chiamata API. Questa guida fa il percorso inverso. Elenca quali permessi dell'account di servizio Google Play servono davvero per rimborsi e chargeback, cosa ogni store consente di fare a una chiave rubata e come contenere il raggio d'impatto.
Cosa consentono davvero i permessi dell'account di servizio Google Play
Un account di servizio è un utente robot. Lo crei in Google Cloud, poi inviti il suo indirizzo email in Play Console, in Users and permissions (utenti e autorizzazioni), come inviteresti un collega. Da quel momento può fare tutto ciò che quei permessi consentono, tramite API, a qualsiasi ora, senza secondo fattore.
I due permessi richiesti dalle API di fatturazione
La guida di Google Play Developer API è precisa. Per usare le API di fatturazione di Google Play concedi due permessi: View financial data, orders, and cancellation survey responses (visualizzare dati finanziari, ordini e risposte al sondaggio di annullamento), e Manage orders and subscriptions (gestire ordini e abbonamenti). Il primo consente all'account di leggere gli ordini e usare l'API Purchases. Il secondo è quello che tocca il denaro.
| Permesso di Play Console | Cosa consente secondo Google | Può restituire denaro agli acquirenti? |
|---|---|---|
| View financial data, orders, and cancellation survey responses | Visualizzare report finanziari, report di vendita e ordini, accedere all'API Purchases, scaricare le risposte al sondaggio di annullamento | No |
| Manage orders and subscriptions | Visualizzare ordini, rimborsare ordini, annullare abbonamenti | Sì |
| Admin (tutti i permessi) | Tutti gli altri permessi, più invitare utenti e modificarne i permessi | Sì, e può concedersi altri permessi |
Cosa può fare una chiave con diritti di rimborso
Il metodo orders.refund di Google Play Developer API rimborsa l'ordine di un abbonamento o di un acquisto in-app. Google precisa che gli ordini con più di 3 anni non possono essere rimborsati, il che significa che tutti quelli più recenti sì. Imposta revoke su true e l'accesso dell'acquirente termina subito. Per gli abbonamenti, purchases.subscriptionsv2.revoke con rimborso totale fa lo stesso.
Sono gli strumenti giusti quando intendi usarli. Le linee guida antifrode di Google dicono di rimborsare e revocare un acquisto che non supera i tuoi controlli invece di lasciarlo scadere. Il problema è una chiave che può farlo su tutte le app del tuo account quando ne serviva una sola.
Quanto può costarti una chiave trapelata
Fai i conti prima di decidere quanto impegno merita. Su Google Play, una chiave con Manage orders and subscriptions può rimborsare ordini una chiamata alla volta, e ogni rimborso restituisce la vendita all'acquirente. Uno script non si stanca. Il tetto è il tuo storico ordini degli ultimi 3 anni.
I costi che non tornano con il rimborso
Un rimborso annulla la vendita. Non annulla quanto hai speso per erogarla. Quella spesa resta a bilancio, che il rimborso l'abbia chiesto un cliente o un attaccante.
- Calcolo già eseguito: tempo di GPU e di server dietro ogni generazione, rendering o risposta del modello ricevuta dall'acquirente.
- Chiamate API già pagate: costi a richiesta di fornitori di modelli, mappe, voce o dati.
- Storage che continui a pagare: i file e lo storico che quegli account conservano ancora sui tuoi server.
- Pagamenti già inviati: i compensi a creator, affiliati o venditori legati a quegli acquisti non tornano con il rimborso.
Sul fronte Apple il rischio ha un'altra forma
App Store Server API di Apple non ha alcun endpoint che emetta rimborsi. I rimborsi li decide Apple. Ma la stessa In-App Purchase key può posticipare la data di rinnovo di un abbonato fino a 90 giorni, due volte ogni 365 giorni per cliente, oppure per tutti gli abbonati attivi di un prodotto con un'unica richiesta massiva. Apple afferma che un'estensione non si può annullare. In quei giorni l'abbonato non paga e continua a usare la tua app, quindi le tue fatture di calcolo, storage e API continuano a correre senza ricavi.
| Cosa può fare una chiave rubata | Account di servizio Google Play con Manage orders and subscriptions | In-App Purchase key di Apple |
|---|---|---|
| Rimborsare un ordine | Sì, ordini fino a 3 anni | No, rimborsa solo Apple |
| Chiudere l'accesso di un acquirente | Sì, con revoke al rimborso | No |
| Annullare o prorogare abbonamenti | Annullare, sì | Posticipare le date di rinnovo fino a 90 giorni, in modo irreversibile |
| Leggere i dati di acquisto | Sì, con il permesso di visualizzazione | Sì, storico di transazioni e rimborsi |
| Rispondere alle revisioni dei rimborsi | Sì, orders.reviewrefund | Sì, Send Consumption Information |
| Limitarla a una sola app | Sì, tramite i permessi dell'app | No, la chiave vale per tutte le app del tuo team |
Come limitare i permessi dell'account di servizio Google Play
Play Console separa i permessi dell'account da quelli dell'app. I permessi dell'app valgono solo per le app che selezioni. Questa singola impostazione fa per la tua sicurezza più di qualsiasi altra voce di questo elenco.
Concedi su una app, non sull'intero account
Invita ogni account di servizio con permessi dell'app solo sulle app che serve. Uno strumento di rimborso per un gioco non ha bisogno di diritti di rimborso sulla tua app di meditazione. Attenzione a una trappola: View financial data, orders, and cancellation survey responses esiste solo a livello di account, e il suo equivalente a livello di app si chiama View financial data. Quando limiti, scegli quello a livello di app.
Separa la lettura dal rimborso
Non tutte le attività richiedono Manage orders and subscriptions. Le analisi che si limitano a leggere gli ordini possono girare su un account con soli permessi di visualizzazione. Tieni la chiave in grado di rimborsare solo sul servizio che chiama davvero orders.refund, orders.reviewrefund o gli endpoint di revoke.
Non dare mai Admin a un robot
Admin concede tutti i permessi, e Google elenca tra i suoi diritti l'invito di utenti e la gestione dei loro permessi. Una chiave Admin trapelata può ampliare il proprio accesso o invitare qualcuno di nuovo. Nessun flusso di rimborso ne ha bisogno.
Chiedi ai fornitori come si collegano
Alcuni strumenti ti chiedono di caricare una chiave JSON. Altri ti danno l'email del proprio account di servizio da invitare, così nessuna tua chiave esce mai dal tuo controllo e puoi revocare il loro accesso da Users and permissions con un clic. Se un fornitore ha bisogno di diritti di rimborso, chiedi quali permessi, su quali app e perché.

Come conservare, ruotare e revocare le chiavi
I due store dicono la stessa cosa con parole diverse. Non mettere chiavi in un repository di codice e non includerle nella tua app. Le differenze stanno in ciò che succede quando qualcosa va storto.
Le chiavi Google Cloud non scadono da sole
Le linee guida di Google Cloud osservano che le chiavi degli account di servizio non hanno una scadenza predefinita. Raccomandano di ruotarle regolarmente e di disattivare quelle che non usi più. Se una chiave finisce in un repository, Google dice di eliminarla in IAM il prima possibile, perché cancellarla dal repository non basta. Google Cloud può anche disattivare automaticamente le chiavi trapelate che rileva quando il vincolo Service Account Key Exposure Response è impostato su DISABLE_KEY, ma non garantisce di intercettare ogni fuga.
Le chiavi Apple si scaricano una volta e si revocano per sempre
Solo un Account Holder o un Admin può generare una In-App Purchase key. Apple conserva la parte pubblica, tu scarichi il file privato .p8 una sola volta e Apple non ne tiene copia. Se sospetti che una chiave sia compromessa, Apple dice di revocarla subito in App Store Connect, in Users and Access, Integrations, In-App Purchase. Una chiave revocata non può essere ripristinata, e revocarla blocca anche il riscatto delle offerte promozionali firmate con essa, quindi aggiorna quelle offerte prima o subito dopo.
| Attività | Account di servizio Google Play | In-App Purchase key di Apple |
|---|---|---|
| Chi può crearla | Creato in Google Cloud, poi invitato in Users and permissions di Play Console | Account Holder o Admin |
| Si può riscaricare il segreto? | Crei una nuova chiave | No, un solo download |
| Scadenza predefinita | Nessuna | Nessuna, finché non la revochi |
| Come tagliare l'accesso in fretta | Eliminare la chiave in IAM o rimuovere l'account in Play Console | Revocare la chiave in App Store Connect |
| Effetti collaterali del taglio | Ogni strumento che usa quell'account smette di chiamare l'API | Le offerte promozionali firmate con essa non si possono più riscattare |
Una breve checklist
- Un account di servizio per attività, invitato con permessi dell'app solo sulle app che serve.
- Manage orders and subscriptions solo sull'account che rimborsa, revoca o risponde davvero alle revisioni.
- Nessun Admin su un account robot.
- Chiavi in un secret manager, mai in un repository, in un log di build o in un'app mobile.
- Un elenco scritto di ogni chiave, di chi l'ha creata e di quale servizio la usa, così una revoca non interrompe le tue risposte ai rimborsi.
- Una revisione di Users and permissions in Play Console e delle chiavi di App Store Connect ogni volta che qualcuno lascia il team o si abbandona un fornitore.
Domande frequenti
- Di quali permessi di Play Console ha bisogno un account di servizio per rimborsi e chargeback?
- Ha bisogno di Manage orders and subscriptions per rimborsare ordini, annullare abbonamenti e lavorare sugli ordini, oltre all'accesso in visualizzazione agli ordini. La guida di Google Play Developer API indica View financial data, orders, and cancellation survey responses e Manage orders and subscriptions come i due permessi richiesti dalle API di fatturazione di Google Play.
- Un account di servizio Google Play può rimborsare ordini?
- Sì, se ha il permesso Manage orders and subscriptions. La pagina di assistenza di Google dice che quel permesso consente di visualizzare ordini, rimborsarli e annullare abbonamenti, e il metodo API orders.refund rimborsa qualsiasi ordine fino a 3 anni.
- Chi ha la mia In-App Purchase key di App Store può rimborsare i miei clienti?
- No. App Store Server API non ha un endpoint di rimborso, perché i rimborsi li decide Apple. Una chiave rubata può comunque leggere lo storico di transazioni e rimborsi, inviare informazioni sul consumo e posticipare le date di rinnovo degli abbonamenti fino a 90 giorni, cosa che secondo Apple non si può annullare.
- Le chiavi degli account di servizio Google Play scadono?
- Non per impostazione predefinita. Le linee guida di Google Cloud dicono che le chiavi che crei e scarichi non hanno scadenza a meno che tu non ne configuri una, e raccomandano di ruotarle regolarmente e di disattivare quelle che non usi più.
- Cosa devo fare se la chiave JSON del mio account di servizio è finita su GitHub?
- Elimina subito la chiave in IAM di Google Cloud e creane una nuova. Google dice che rimuovere la chiave dal repository non basta, perché chiunque l'abbia copiata può continuare a usarla finché la chiave stessa non viene eliminata.
Fonti e approfondimenti
- 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
Il pilota automatico dei rimborsi per App Store e Google Play
Continua a leggere
Il Brasile ora controlla quali giochi vendono ancora loot box ai minori, e il conto arriva con i rimborsi delle loot box
Il ministero della Giustizia brasiliano ha chiesto all'autorità per la protezione dei dati di monitorare sei giochi che vendono loot box senza verificare l'età. Ecco cosa richiede la legge, cosa chiedono già Apple e Google e come valutare e gestire i rimborsi delle loot box quando la scatola è già stata aperta.
Gli acquisti in-app accidentali sono i rimborsi che non puoi vincere, quindi la soluzione sta nella tua schermata di acquisto
Gli acquisti in-app accidentali tornano indietro come rimborsi su entrambi gli store, e nessun dato di utilizzo dimostra che un tocco fosse voluto. Ecco come Apple e Google li etichettano, quanto ti costa ciascuno in calcolo e pagamenti, e il design della schermata di acquisto che li ferma prima che l'addebito esista.