Todos os artigos
Análise aprofundada7 min de leitura

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.

A mesa de um desenvolvedor Android sob a luz da manhã, com um notebook, um celular e um calendário de parede com uma data circulada, na semana em que a Play Billing Library 8 virou o mínimo para atualizações no Google Play

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 bibliotecaPrazo para apps novos e atualizaçõesPrazo da extensão
631 de agosto de 20251º de novembro de 2025
731 de agosto de 20261º de novembro de 2026
831 de agosto de 20271º de novembro de 2027
931 de agosto de 20281º 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 agoraOnde roda
Compras ativas e pendentesqueryPurchasesAsync()No dispositivo
Compras únicas consumidasSeus próprios registrosSeu servidor
Compras reembolsadas, canceladas ou com chargebackVoided Purchases APISeu servidor
O histórico completo de compras de um usuárioSeus próprios registrosSeu 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.

Um engenheiro com um tablet num corredor silencioso de servidores, onde as compras reembolsadas e consumidas do Google Play agora precisam ser registradas depois que a Play Billing Library 8 removeu o histórico de compras do cliente

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

RefundHalt

O piloto automático de reembolsos para App Store e Google Play

Continue lendo

A próxima solicitação de reembolso já está a caminho.

Configure a RefundHalt no tempo que você levaria para ler mais um e-mail de suporte sobre um reembolso que não conseguiu contestar.