Tutti gli articoli
Guida pratica8 min di lettura

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.

Una chiave d'ottone su una scrivania scura accanto a un portatile e a uno smartphone, a rappresentare i permessi dell'account di servizio Google Play che controllano i rimborsi

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 ConsoleCosa consente secondo GooglePuò restituire denaro agli acquirenti?
View financial data, orders, and cancellation survey responsesVisualizzare report finanziari, report di vendita e ordini, accedere all'API Purchases, scaricare le risposte al sondaggio di annullamentoNo
Manage orders and subscriptionsVisualizzare ordini, rimborsare ordini, annullare abbonamentiSì
Admin (tutti i permessi)Tutti gli altri permessi, più invitare utenti e modificarne i permessiSì, 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 rubataAccount di servizio Google Play con Manage orders and subscriptionsIn-App Purchase key di Apple
Rimborsare un ordineSì, ordini fino a 3 anniNo, rimborsa solo Apple
Chiudere l'accesso di un acquirenteSì, con revoke al rimborsoNo
Annullare o prorogare abbonamentiAnnullare, sìPosticipare le date di rinnovo fino a 90 giorni, in modo irreversibile
Leggere i dati di acquistoSì, con il permesso di visualizzazioneSì, storico di transazioni e rimborsi
Rispondere alle revisioni dei rimborsiSì, orders.reviewrefundSì, Send Consumption Information
Limitarla a una sola appSì, tramite i permessi dell'appNo, 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é.

Una sviluppatrice alla scrivania che revoca un accesso su un portatile, con una fila di chiavi appese ai ganci alla parete e un gancio vuoto, a illustrare come rimuovere i permessi dell'account di servizio Google Play

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 PlayIn-App Purchase key di Apple
Chi può crearlaCreato in Google Cloud, poi invitato in Users and permissions di Play ConsoleAccount Holder o Admin
Si può riscaricare il segreto?Crei una nuova chiaveNo, un solo download
Scadenza predefinitaNessunaNessuna, finché non la revochi
Come tagliare l'accesso in frettaEliminare la chiave in IAM o rimuovere l'account in Play ConsoleRevocare la chiave in App Store Connect
Effetti collaterali del taglioOgni strumento che usa quell'account smette di chiamare l'APILe 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

RefundHalt

Il pilota automatico dei rimborsi per App Store e Google Play

Continua a leggere

La prossima richiesta di rimborso è già in arrivo.

Configura RefundHalt nel tempo che impiegheresti a leggere un'altra e-mail dell'assistenza su un rimborso che non sei riuscito a contestare.