Play Billing Library 8 ora è obbligatoria per ogni aggiornamento su Google Play e sposta il monitoraggio dei rimborsi sul tuo server
La proroga di Google per Play Billing Library 7 è scaduta il 1° novembre 2026, quindi le nuove app e gli aggiornamenti richiedono la versione 8 o successiva. La versione 8 ha rimosso queryPurchaseHistory(), il che significa che gli acquisti rimborsati e consumati vanno tracciati lato server. Ecco cosa è cambiato e quanto costa una migrazione lenta.

Punti chiave
- La tabella di deprecazione di Google ha fissato il 31 agosto 2026 come ultimo giorno per nuove app e aggiornamenti con Play Billing Library 7, e le proroghe sono terminate il 1° novembre 2026. Ogni aggiornamento su Google Play ora richiede Play Billing Library 8 o successiva.
- Le app già pubblicate con Play Billing Library 7 continuano a funzionare, perché Google afferma che la deprecazione blocca solo nuove app e aggiornamenti, non le installazioni esistenti.
- Play Billing Library 8 ha rimosso queryPurchaseHistory(), e la soluzione sostitutiva di Google è lato server: traccia gli acquisti consumati sul tuo backend e recupera quelli rimborsati o annullati dalla Voided Purchases API.
- La Voided Purchases API di Google Play mostra solo gli acquisti annullati negli ultimi 30 giorni e consente 6.000 query al giorno e 30 query in qualsiasi intervallo di 30 secondi per app.
- Google Play rimborsa ancora automaticamente un acquisto e revoca l'accesso se l'app non lo conferma entro tre giorni, e una migrazione difettosa a Play Billing Library 8 può farlo succedere su ogni vendita.
- La revisione degli storni di Google Play è l'unico flusso di rimborso Android che chiede prove allo sviluppatore, tramite orders.reviewrefund entro 24 ore dalla PendingRefundReviewNotification.
- Per gli ordini Google Play effettuati dopo il 3 agosto 2026, lo sviluppatore paga il prezzo d'acquisto, meno la commissione di servizio di Play, più le commissioni bancarie di storno per ogni storno perso.
Ogni app Android che vende tramite Google Play ora deve includere Play Billing Library 8 o successiva nel prossimo aggiornamento. La scadenza della versione 7 per nuove app e aggiornamenti era il 31 agosto 2026, e le ultime proroghe sono scadute il 1° novembre 2026. Le date sono in una tabella delle FAQ di Google sulla deprecazione, e i promemoria arrivano come avvisi nella pagina Stato delle norme di Play Console.
Per la maggior parte dei team si tratta di aggiornare una dipendenza e rinominare qualche metodo. Per i rimborsi, è qualcosa di più. Play Billing Library 8 ha eliminato l'unica chiamata client che permetteva a un'app di consultare gli acquisti passati. D'ora in poi, se vuoi sapere cosa ha comprato, consumato o si è fatto rimborsare un utente, deve ricordarlo il tuo server.
Cosa blocca davvero la scadenza di Play Billing Library 8
Google dà a ogni versione della libreria due anni di vita. La deprecazione ferma solo nuove app e aggiornamenti. Le FAQ di Google dicono che le app esistenti continuano a funzionare e che gli APK non mantenuti non devono essere aggiornati. Quindi oggi non si rompe nulla in un'app che non tocchi più. Si rompe il giorno in cui provi a pubblicare una correzione, un nuovo prezzo o un nuovo paywall.
| Versione della libreria | Scadenza per nuove app e aggiornamenti | Scadenza della proroga |
|---|---|---|
| 6 | 31 agosto 2025 | 1° novembre 2025 |
| 7 | 31 agosto 2026 | 1° novembre 2026 |
| 8 | 31 agosto 2027 | 1° novembre 2027 |
| 9 | 31 agosto 2028 | 1° novembre 2028 |
La versione 8.0.0 è uscita il 30 giugno 2025. La versione 9.0.0 è arrivata il 19 maggio 2026. Se migri adesso, passare direttamente alla 9 ti fa guadagnare un anno in più rispetto a fermarti alla 8.
Perché Play Billing Library 8 conta per i rimborsi
La rimozione principale è queryPurchaseHistory(). È stata deprecata nella versione 7 e rimossa nella 8.0.0. Le note di migrazione di Google dividono il suo vecchio compito in tre parti, e solo una resta sul dispositivo.
| Per cosa usavi queryPurchaseHistory() | Cosa dice Google di usare ora | Dove viene eseguito |
|---|---|---|
| Acquisti attivi e in sospeso | queryPurchasesAsync() | Sul dispositivo |
| Acquisti una tantum consumati | I tuoi registri | Il tuo server |
| Acquisti rimborsati, annullati o stornati | Voided Purchases API | Il tuo server |
| La cronologia acquisti completa di un utente | I tuoi registri | Il tuo server |
Posso ancora ripristinare gli acquisti consumabili su Android?
Non dal client. queryPurchasesAsync() restituisce ciò che è attivo, quindi un pacchetto di crediti consumato o un lotto di gemme esaurito non torna mai indietro da lì. Se un utente reinstalla e chiede dove sono finite le sue monete, la risposta deve venire dal registro che hai tenuto quando è avvenuto l'acquisto. Le app che usavano la cronologia acquisti come backup gratuito l'hanno persa.
Come vengo a sapere dei rimborsi adesso?
Tramite due canali lato server. Le notifiche in tempo reale per sviluppatori inviano una VoidedPurchaseNotification con il token d'acquisto, l'ID ordine, il tipo di prodotto e un tipo di rimborso, che può essere totale o parziale in base alla quantità. La Voided Purchases API ti permette di recuperare gli stessi eventi per intervallo di tempo, come rete di sicurezza per tutto ciò che ti è sfuggito.
L'API di recupero ha limiti rigidi. Mostra solo gli acquisti annullati negli ultimi 30 giorni. Ogni app ha 6.000 query al giorno e 30 query in qualsiasi intervallo di 30 secondi. E un rimborso effettuato dallo sviluppatore senza l'opzione di revoca non viene restituito affatto. Un server fermo per cinque settimane perde rimborsi che non potrà mai recuperare.

Su quali rimborsi lo sviluppatore ha ancora voce in capitolo
Spostare il monitoraggio dei rimborsi sul server non ti dà più controllo sui rimborsi. Quasi tutti i rimborsi di Google Play vengono decisi senza di te: rimborsi self-service, rimborsi dell'assistenza, annullamenti e rimborsi automatici degli acquisti non confermati. Lo scopri a cose fatte, tramite la notifica di acquisto annullato.
L'eccezione è la revisione degli storni. Quando un acquirente presenta uno storno che richiede il tuo intervento, Google invia una PendingRefundReviewNotification. Google dice che devi rispondere con un suggerimento di rimborso e prove di utilizzo entro 24 ore chiamando orders.reviewrefund. Quelle prove vengono dagli stessi registri lato server che la nuova libreria ti obbliga a tenere. Un team che tiene già un registro per i ripristini ha ciò che serve per rispondere.
Quanto costa in denaro una migrazione lenta
Il rischio diretto è la regola dei tre giorni. Google Play rimborsa automaticamente un acquisto e revoca l'accesso se la tua app non lo conferma entro tre giorni. Per gli acquisti in sospeso, il conteggio parte quando l'acquisto passa da PENDING a PURCHASED. Una migrazione che rompe la logica di connessione, il nuovo listener di queryProductDetailsAsync() o la configurazione degli acquisti in sospeso può bloccare le conferme senza bloccare le vendite. Ogni ordine in quell'intervallo viene rimborsato per intero, e l'utente ha già ricevuto ciò che ha pagato.
È lì che fa male. Un pacchetto di crediti per immagini rimborsato ha comunque consumato il tempo GPU di ogni generazione. Un piano IA rimborsato ha comunque eseguito le chiamate API a pagamento. Un piano di archiviazione rimborsato ha comunque riempito i dischi che paghi. Una mancia rimborsata è comunque finita nel pagamento a un creator. Il rimborso restituisce i ricavi all'acquirente e lascia a te quei costi.
Anche gli storni sono diventati più cari. Il centro assistenza di Google dice che, per gli ordini effettuati dopo il 3 agosto 2026, lo sviluppatore copre il prezzo d'acquisto, meno la commissione di servizio di Play, più le commissioni di storno della banca. Google continua a pagare solo la propria commissione di servizio. Un'app che non riesce a rispondere a una revisione di storno entro 24 ore con dati di utilizzo reali paga quel conto per intero ogni volta.
Una checklist di migrazione che protegge i ricavi
- Aggiorna la dipendenza a Play Billing Library 8 o 9 e rimuovi
queryPurchaseHistory(),querySkuDetailsAsync()eenablePendingPurchases()senza argomenti. - Aggiorna il tuo listener di
queryProductDetailsAsync(). Dalla versione 8 restituisce anche i prodotti che non è stato possibile recuperare, con un codice di stato. - Attiva
enableAutoServiceReconnection()così una connessione di fatturazione interrotta non blocca l'elaborazione degli acquisti. - Chiama
queryPurchasesAsync()inonResume()così gli acquisti completati ad app chiusa vengono comunque confermati entro tre giorni. - Registra sul tuo server ogni token d'acquisto, ID ordine e consumo, collegato al tuo ID account.
- Iscriviti alle notifiche in tempo reale per sviluppatori e gestisci sia
VoidedPurchaseNotificationsiaPendingRefundReviewNotification. - Esegui una sincronizzazione giornaliera con la Voided Purchases API come rete di sicurezza, ben dentro la finestra di 30 giorni e la quota giornaliera di 6.000 query.
RefundHalt ascolta le notifiche di acquisto annullato e di revisione degli storni di Google Play, risponde a ogni revisione tramite orders.reviewrefund entro la finestra di 24 ore con i tuoi dati di utilizzo reali e conserva la cronologia dei rimborsi che la tua app non può più chiedere al dispositivo.
Domande frequenti
- Devo usare Play Billing Library 8 adesso?
- Sì, per qualsiasi nuova app o aggiornamento che vende tramite la fatturazione di Google Play. La tabella di deprecazione di Google ha fissato il 31 agosto 2026 come scadenza per la versione 7, e le proroghe sono terminate il 1° novembre 2026. Puoi usare la versione 8 o la più recente, la 9.
- La mia app esistente smetterà di funzionare se usa ancora Play Billing Library 7?
- No. Google dice che le app esistenti continuano a funzionare e che gli APK non mantenuti non devono essere aggiornati. La deprecazione ti impedisce solo di pubblicare una nuova app o un aggiornamento che usa una versione non supportata.
- Cosa ha sostituito queryPurchaseHistoryAsync in Play Billing Library 8?
- Niente sul dispositivo fa lo stesso lavoro. Google dice di usare queryPurchasesAsync() per gli acquisti attivi e in sospeso, di tracciare gli acquisti consumati sul tuo server e di usare la Voided Purchases API per gli acquisti annullati o rimborsati.
- Quanto indietro nel tempo arriva la Voided Purchases API di Google Play?
- 30 giorni. Google dice che l'API può mostrare solo gli acquisti annullati avvenuti negli ultimi 30 giorni, e limita ogni app a 6.000 query al giorno e 30 query in qualsiasi intervallo di 30 secondi.
- Google Play rimborsa un acquisto se la mia app non lo conferma?
- Sì. Se un acquisto non viene confermato entro tre giorni, l'utente riceve automaticamente un rimborso e Google Play revoca l'acquisto. Per gli acquisti in sospeso, i tre giorni partono quando lo stato passa da PENDING a PURCHASED.
Fonti e approfondimenti
- 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
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.