A Play Billing Library 8 agora é obrigatória em toda atualização no Google Play e leva o controle de reembolsos para o seu servidor
A extensão do Google para a Play Billing Library 7 acabou em 1º de novembro de 2026, então apps novos e atualizações precisam da versão 8 ou mais recente. A versão 8 removeu queryPurchaseHistory(), o que significa que compras reembolsadas e consumidas precisam ser registradas no servidor. Veja o que mudou e quanto custa uma migração lenta.

Principais conclusões
- A tabela de descontinuação do Google definiu 31 de agosto de 2026 como o último dia para apps novos e atualizações com a Play Billing Library 7, e as extensões terminaram em 1º de novembro de 2026. Qualquer atualização no Google Play agora precisa da Play Billing Library 8 ou mais recente.
- Apps já publicados com a Play Billing Library 7 continuam funcionando, porque o Google diz que a descontinuação só bloqueia apps novos e atualizações, não as instalações existentes.
- A Play Billing Library 8 removeu queryPurchaseHistory(), e o plano de substituição do Google é no servidor: registre as compras consumidas no seu próprio backend e busque as reembolsadas ou canceladas na Voided Purchases API.
- A Voided Purchases API do Google Play só mostra compras anuladas dos últimos 30 dias e permite 6.000 consultas por dia e 30 consultas em qualquer período de 30 segundos por app.
- O Google Play ainda reembolsa uma compra automaticamente e revoga o acesso se o app não a confirmar em até três dias, e uma migração quebrada para a Play Billing Library 8 pode causar isso em todas as vendas.
- A análise de chargeback do Google Play é o único fluxo de reembolso no Android que pede provas ao desenvolvedor, por meio de orders.reviewrefund em até 24 horas após a PendingRefundReviewNotification.
- Para pedidos do Google Play feitos depois de 3 de agosto de 2026, o desenvolvedor paga o preço da compra, menos a taxa de serviço do Play, mais as taxas de chargeback do banco a cada chargeback perdido.
Todo app Android que vende pelo Google Play agora precisa incluir a Play Billing Library 8 ou mais recente na próxima atualização. O prazo da versão 7 para apps novos e atualizações era 31 de agosto de 2026, e as últimas extensões acabaram em 1º de novembro de 2026. As datas estão numa tabela das perguntas frequentes do Google sobre descontinuação, e os lembretes chegam como avisos na página de status da política do Play Console.
Para a maioria das equipes, é atualizar uma dependência e renomear alguns métodos. Para reembolsos, é mais do que isso. A Play Billing Library 8 apagou a única chamada do cliente que deixava um app consultar compras passadas. Daqui em diante, se você quer saber o que um usuário comprou, consumiu ou teve reembolsado, seu servidor precisa guardar essa informação.
O que o prazo da Play Billing Library 8 realmente bloqueia
O Google dá a cada versão da biblioteca dois anos de vida. A descontinuação só impede apps novos e atualizações. As perguntas frequentes do Google dizem que apps existentes continuam funcionando e que APKs sem manutenção não precisam de atualização. Então nada quebra hoje num app que você parou de mexer. Quebra no dia em que você tenta publicar uma correção, um preço novo ou um paywall novo.
| Versão da biblioteca | Prazo para apps novos e atualizações | Prazo da extensão |
|---|---|---|
| 6 | 31 de agosto de 2025 | 1º de novembro de 2025 |
| 7 | 31 de agosto de 2026 | 1º de novembro de 2026 |
| 8 | 31 de agosto de 2027 | 1º de novembro de 2027 |
| 9 | 31 de agosto de 2028 | 1º de novembro de 2028 |
A versão 8.0.0 saiu em 30 de junho de 2025. A versão 9.0.0 veio em 19 de maio de 2026. Se você vai migrar agora, ir direto para a 9 te dá um ano a mais do que parar na 8.
Por que a Play Billing Library 8 importa para reembolsos
A remoção principal é queryPurchaseHistory(). Ela foi descontinuada na versão 7 e removida na 8.0.0. As notas de migração do Google dividem a antiga função dela em três partes, e só uma fica no dispositivo.
| Para que você usava queryPurchaseHistory() | O que o Google manda usar agora | Onde roda |
|---|---|---|
| Compras ativas e pendentes | queryPurchasesAsync() | No dispositivo |
| Compras únicas consumidas | Seus próprios registros | Seu servidor |
| Compras reembolsadas, canceladas ou com chargeback | Voided Purchases API | Seu servidor |
| O histórico completo de compras de um usuário | Seus próprios registros | Seu servidor |
Ainda dá para restaurar compras consumíveis no Android?
Não pelo cliente. queryPurchasesAsync() retorna o que está ativo, então um pacote de créditos consumido ou um lote de gemas já gasto nunca volta por ali. Se um usuário reinstala e pergunta onde foram parar as moedas, a resposta tem que vir do registro que você guardou quando a compra aconteceu. Apps que usavam o histórico de compras como backup gratuito perderam esse backup.
Como fico sabendo dos reembolsos agora?
Por dois canais no servidor. As notificações do desenvolvedor em tempo real enviam uma VoidedPurchaseNotification com o token da compra, o ID do pedido, o tipo de produto e um tipo de reembolso que pode ser total ou parcial por quantidade. A Voided Purchases API permite buscar os mesmos eventos por intervalo de tempo, como reforço para o que tiver escapado.
A API de consulta tem limites rígidos. Ela só mostra compras anuladas dos últimos 30 dias. Cada app tem 6.000 consultas por dia e 30 consultas em qualquer período de 30 segundos. E um reembolso do desenvolvedor feito sem a opção de revogar nem aparece. Um servidor fora do ar por cinco semanas perde reembolsos que nunca vai conseguir recuperar.

Em quais reembolsos o desenvolvedor ainda tem voz
Levar o controle de reembolsos para o servidor não te dá mais controle sobre eles. Quase todo reembolso do Google Play é decidido sem você: reembolsos de autoatendimento, reembolsos do suporte, cancelamentos e reembolsos automáticos de compras não confirmadas. Você fica sabendo depois, pela notificação de compra anulada.
A exceção é a análise de chargeback. Quando um comprador abre um chargeback que precisa da sua resposta, o Google envia uma PendingRefundReviewNotification. O Google diz que você deve responder com uma sugestão de reembolso e provas de uso em até 24 horas chamando orders.reviewrefund. Essas provas vêm dos mesmos registros no servidor que a nova biblioteca te obriga a manter. Uma equipe que já mantém um registro para restaurações tem o que precisa para responder.
Quanto uma migração lenta custa em dinheiro
O risco direto é a regra dos três dias. O Google Play reembolsa uma compra automaticamente e revoga o acesso se o seu app não a confirmar em até três dias. Em compras pendentes, o prazo começa quando a compra passa de PENDING para PURCHASED. Uma migração que quebra a lógica de conexão, o novo listener de queryProductDetailsAsync() ou a configuração de compras pendentes pode parar as confirmações sem parar as vendas. Todo pedido nesse intervalo é reembolsado integralmente, e o usuário já recebeu o que pagou.
É aí que dói. Um pacote de créditos de imagem reembolsado já gastou o tempo de GPU de cada geração. Um plano de IA reembolsado já fez as chamadas de API pagas. Um plano de armazenamento reembolsado já ocupou os discos que você paga. Uma gorjeta reembolsada já saiu no repasse a um criador. O reembolso devolve a receita ao comprador e deixa essas contas com você.
Os chargebacks também ficaram mais caros. A central de ajuda do Google diz que, para pedidos feitos depois de 3 de agosto de 2026, o desenvolvedor cobre o preço da compra, menos a taxa de serviço do Play, mais as taxas de chargeback do banco. O Google continua pagando só a própria taxa de serviço. Um app que não consegue responder uma análise de chargeback em 24 horas com dados de uso reais paga essa conta inteira toda vez.
Um checklist de migração que protege a receita
- Atualize a dependência para a Play Billing Library 8 ou 9 e remova
queryPurchaseHistory(),querySkuDetailsAsync()eenablePendingPurchases()sem argumentos. - Atualize seu listener de
queryProductDetailsAsync(). Desde a versão 8 ele também retorna os produtos que não puderam ser buscados, com um código de status. - Ative
enableAutoServiceReconnection()para que uma conexão de faturamento perdida não trave o processamento de compras. - Chame
queryPurchasesAsync()emonResume()para que compras concluídas com o app fechado ainda sejam confirmadas dentro dos três dias. - Registre no seu servidor cada token de compra, ID de pedido e consumo, vinculado ao seu próprio ID de conta.
- Assine as notificações do desenvolvedor em tempo real e trate tanto
VoidedPurchaseNotificationquantoPendingRefundReviewNotification. - Rode uma sincronização diária com a Voided Purchases API como rede de segurança, bem dentro da janela de 30 dias e da cota diária de 6.000 consultas.
O RefundHalt recebe as notificações de compras anuladas e de análise de chargeback do Google Play, responde cada análise por meio de orders.reviewrefund dentro da janela de 24 horas com seus dados de uso reais e guarda o histórico de reembolsos que o seu app não pode mais pedir ao dispositivo.
Perguntas frequentes
- Preciso usar a Play Billing Library 8 agora?
- Sim, para qualquer app novo ou atualização que venda pelo faturamento do Google Play. A tabela de descontinuação do Google definiu 31 de agosto de 2026 como prazo para a versão 7, e as extensões terminaram em 1º de novembro de 2026. Você pode usar a versão 8 ou a mais nova, a 9.
- Meu app atual vai parar de funcionar se ainda usar a Play Billing Library 7?
- Não. O Google diz que apps existentes continuam funcionando e que APKs sem manutenção não precisam de atualização. A descontinuação só impede que você publique um app novo ou uma atualização que use uma versão sem suporte.
- O que substituiu queryPurchaseHistoryAsync na Play Billing Library 8?
- Nada no dispositivo faz o mesmo trabalho. O Google diz para usar queryPurchasesAsync() para compras ativas e pendentes, registrar as compras consumidas no seu próprio servidor e usar a Voided Purchases API para compras canceladas ou reembolsadas.
- Até quando a Voided Purchases API do Google Play volta no tempo?
- 30 dias. O Google diz que a API só consegue mostrar compras anuladas que aconteceram nos últimos 30 dias, e limita cada app a 6.000 consultas por dia e 30 consultas em qualquer período de 30 segundos.
- O Google Play reembolsa uma compra se o meu app não a confirmar?
- Sim. Se uma compra não for confirmada em até três dias, o usuário recebe um reembolso automático e o Google Play revoga a compra. Em compras pendentes, os três dias começam quando o estado muda de PENDING para PURCHASED.
Fontes e leituras adicionais
- 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
O piloto automático de reembolsos para App Store e Google Play
Continue lendo
O Brasil agora fiscaliza quais jogos ainda vendem caixas de recompensa a crianças, e a conta chega nos reembolsos de loot boxes
O Ministério da Justiça pediu à autoridade de proteção de dados que monitore seis jogos que vendem caixas de recompensa sem verificar a idade. Veja o que a lei exige, o que Apple e Google já cobram e como precificar e tratar reembolsos de loot boxes quando a caixa já foi aberta.
Compras in-app acidentais são os reembolsos que você não consegue vencer, então a solução está na sua tela de compra
Compras in-app acidentais voltam como reembolsos nas duas lojas, e nenhum dado de uso prova que um toque foi intencional. Veja como a Apple e o Google as classificam, quanto cada uma custa em processamento e repasses, e o design de tela de compra que as impede antes que a cobrança exista.