Tutti gli articoli
Analisi approfondita7 min di lettura

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.

La scrivania di uno sviluppatore Android nella luce del mattino, con un portatile, uno smartphone e un calendario da parete con una data cerchiata, la settimana in cui Play Billing Library 8 è diventata il minimo per gli aggiornamenti su Google Play

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 libreriaScadenza per nuove app e aggiornamentiScadenza della proroga
631 agosto 20251° novembre 2025
731 agosto 20261° novembre 2026
831 agosto 20271° novembre 2027
931 agosto 20281° 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 oraDove viene eseguito
Acquisti attivi e in sospesoqueryPurchasesAsync()Sul dispositivo
Acquisti una tantum consumatiI tuoi registriIl tuo server
Acquisti rimborsati, annullati o stornatiVoided Purchases APIIl tuo server
La cronologia acquisti completa di un utenteI tuoi registriIl 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.

Un ingegnere con un tablet in un corridoio silenzioso tra i server, dove gli acquisti Google Play rimborsati e consumati ora vanno registrati dopo che Play Billing Library 8 ha rimosso la cronologia acquisti lato client

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() e enablePendingPurchases() 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() in onResume() 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 VoidedPurchaseNotification sia PendingRefundReviewNotification.
  • 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

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.