KappS Base de conhecimento · Blog

Google Play Reembolsos e estornos em 2026

Blog Guia

O Google Play mudou as regras de reembolso para desenvolvedores em 3 de agosto de 2026 — não a parte que o usuário vê, mas a que decide quem paga quando uma compra vira disputa. Os custos de chargeback agora são compartilhados, e uma nova API permite defender seu lado de um chargeback antes da decisão. Se o seu app vende assinaturas ou desbloqueios avulsos e você nunca olhou o fluxo de compras anuladas, é neste trimestre que vale corrigir isso.

Abaixo está a sequência operacional: o que a divisão de custos realmente diz, como distinguir um reembolso de um chargeback no Play Console, a única fonte de dados de pedidos que enxerga chargebacks do processador e a janela de 24 horas que define quanto de uma disputa você assume.

Três números definem a exposição: 3 de agosto de 2026 — pedidos feitos após essa data ficam sujeitos ao novo compartilhamento de custos de chargeback. 24 horas — quanto tempo você tem para responder a uma PendingRefundReviewNotification por meio da API Review Refund. 30 dias — o período máximo de consulta retroativa da API Voided Purchases, e a única fonte de dados de pedidos que inclui compras estornadas por processadores de pagamento.

1. O que mudou em 3 de agosto

A página de ajuda do Play Console Atualizações na proteção contra reembolsos e na responsabilidade pelos custos de chargeback apresenta a mudança em termos claros: o Google Play evitou US$3.4B em fraudes e abusos em 2025, está adicionando mais salvaguardas e detecção de fraudes em 2026 para reduzir o abuso de reembolsos e — para se alinhar aos padrões do setor — começará a compartilhar os custos de chargeback com os desenvolvedores para pedidos feitos após 3 de agosto de 2026.

A divisão é específica. Um chargeback é uma contestação que o usuário abre diretamente com o banco ou com a emissora do cartão, não com o Play. Quando isso acontece:

  • Desenvolvedor: o preço da compra (menos a taxa de serviço do Play) mais as tarifas de chargeback cobradas pela instituição financeira.
  • Google Play: continua a cobrir a taxa de serviço dessa transação.

Então uma venda contestada deixa de ser neutra em receita para você. Você devolve o que recebeu e absorve uma taxa bancária por contestação, enquanto a Google abre mão da própria comissão. O tamanho do valor devolvido depende da sua faixa de taxa de serviço, que a Google documenta em Taxas de serviço — e esse documento também mudou: para transações com usuários no EEE, no Reino Unido ou nos EUA a partir de 30 de junho de 2026, a taxa depende de a instalação do usuário ser classificada como nova ou existente (assinaturas com renovação automática são tratadas separadamente, e o primeiro US$1M de ganhos anuais fica na faixa mais baixa). Antes de modelar o custo de uma onda de chargebacks, confirme em qual faixa sua conta realmente está.

2. Quatro eventos diferentes parecem idênticos nos seus relatórios de receita

A documentação da Voided Purchases API lista o que pode invalidar uma compra, e não são o mesmo evento de forma alguma:

  • o usuário solicita o reembolso do pedido;
  • o usuário cancela o pedido;
  • a ordem é estornada;
  • o desenvolvedor cancela ou reembolsa o pedido;
  • O Google cancela ou reembolsa o pedido.

Essa API cobre pedidos únicos dentro do app e Assinaturas do App, e vem com um aviso que vale ler duas vezes: diferente de outras fontes de dados de pedidos, ela inclui compras estornadas pelos processadores de pagamento, então você deve esperar inconsistências entre essa API e outros dados de pedidos. Relatórios financeiros e seu sistema de direitos legitimamente divergem aqui — saber disso com antecedência é o que evita um alarme falso.

Duas mecânicas decorrem da mesma página. Apenas pedidos revogados são retornados: se você reembolsar uma compra sem marcar a opção de revogação, o pedido não aparecerá na API de jeito nenhum. E algumas compras são reembolsadas sob a alegação de que a compra nunca foi reconhecida pelo desenvolvedor — ou seja, o pedido reembolsado pode nem existir nos seus próprios registros desde o início.

3. Etapa 1 — classifique o pedido no Play Console

Gerencie os pedidos do seu app e emita reembolsos é onde os eventos financeiros aparecem, e os rótulos de status carregam a distinção que agora custa dinheiro:

  • Reembolso pendente — um reembolso solicitado ainda não processado.
  • Reembolsado — com duas variantes que importam: Este reembolso foi pago por Google e Este reembolso foi um estorno.
  • Reembolso parcial pendente / Parcialmente reembolsado — para valores parciais.

A variante de chargeback é a mais cara: o dinheiro saiu porque o usuário foi ao banco, não porque você aprovou algo. A mesma página também confirma que você pode emitir reembolsos totais ou parciais de compras dentro do app e apps pagos por conta própria — o caminho mais barato quando um usuário está insatisfeito e ainda pode ser contatado.

4. Etapa 2 — integre a API Voided Purchases

É este o pipeline que permite que você reaja, e suas restrições estão documentadas com precisão:

  • Endpoint: GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/purchases/voidedpurchases, authorised with an OAuth client or service account that holds the View financial reports permission.
  • Período retroativo: no máximo os últimos 30 dias. Compras anuladas mais antigas não são retornadas, independentemente do startTime enviado; o padrão é 30 dias atrás.
  • Paginação: maxResults tem valor padrão 1000 e o máximo também é 1000; um nextPageToken continua a lista. Continue usando tokens de continuação em vez de aumentar o tamanho da página.
  • Assinaturas: type=0 retorna apenas compras dentro do app; type=1 inclui compras de assinatura, e assim que você pedir assinaturas precisa passar a usar orderId na resposta, porque uma visão só de assinaturas retorna vários pedidos compartilhando um mesmo purchaseToken.
  • Reembolsos parciais: includeQuantityBasedPartialRefund=true adiciona reembolsos parciais baseados em quantidade que carregam um voidedQuantity. Quando a quantidade restante é finalmente reembolsada, esse registro não tem voidedQuantity — essa ausência é o sinal documentado de uma compra com múltiplas quantidades totalmente reembolsada.

Uma sutileza que quebra junções ingênuas por janela de tempo: os registros são filtrados por quando a API viu o pedido ser anulado, e não pelo valor de voidedTimeMillis retornado na resposta. Um job que roda mensalmente e perde uma execução silenciosamente perde registros, porque a janela nunca se estende. Agende com mais frequência do que a janela, faça dedupe por orderId ou purchaseToken e trate a resposta como um sinal de revogação, não como um livro contábil completo.

5. Passo 3 — responda ao chargeback em até 24 horas

O guia do Google AjudaGoogle a contestar chargebacks descreve o novo fluxo, e ele tem prazo definido:

  1. Fique atento à notificação. Quando um usuário inicia um chargeback que exige análise do desenvolvedor, o Play envia a notificação em tempo real para desenvolvedores PendingRefundReviewNotification. A referência de RTDN a lista como campo de primeira classe de DeveloperNotification, mutuamente exclusiva com as notificações voidedPurchaseNotification, de produto único, de assinatura e de teste.
  2. Reúna evidências e responda em até 24 horas após receber a notificação, chamando a API Review Refund. Você informa uma preferência de reembolso e evidências de uso da compra — o estado de entrega do pedido e se o item foi consumido.
  3. Conheça a regra do disparo único. O Play registra a primeira chamada de API feita em resposta a uma notificação e ignora as chamadas seguintes, ainda retornando um status OK. Uma integração que dispara duas vezes não é corrigida por uma segunda tentativa, e um payload mapeado incorretamente não tem conserto depois do fato.

A API de Reembolso de Revisão é descrita como opcional — o Google não exige que você responda. Mas, uma vez que você arca com o preço da compra e a taxa bancária, o silêncio se torna a opção cara, e o prazo de 24 horas significa que a integração precisa existir antes de a primeira notificação chegar. É o mesmo padrão das notificações em tempo real do desenvolvedor em geral: um webhook ou uma assinatura Pub/Sub funcionando e testado é o pré-requisito, não uma tarefa posterior.

6. Etapa 4 — teste o caminho do chargeback antes de precisar dele

O Google documenta um fluxo de teste para estornos iniciados pelo usuário no guia de testes do Play Billing, que é a única forma confiável de confirmar três coisas: que seu assinante de RTDN realmente recebe uma PendingRefundReviewNotification, que seu handler a associa ao pedido e ao token de compra corretos, e que sua chamada de revisão de reembolso é bem-sucedida em uma compra de teste. Mantenha o handler idempotente e registre a primeira resposta, já que apenas a primeira chamada conta. Confirme o caminho da notificação de ponta a ponta — uma assinatura configurada mas nunca exercitada não é um controle.

7. Etapa 5 — entenda o que os reembolsos fazem com o seu repasse

A página de gerenciamento de pedidos também detalha a mecânica do dinheiro, e ela é pior do que parece:

  • Reembolso antes do repasse → o valor não é incluído no seu próximo repasse.
  • Reembolso após o repasse → o valor é descontado de um repasse futuro.
  • Se o seu saldo ficar negativo e permanecer negativo por pelo menos 48 horas, o Google cobra os fundos de acordo com os Termos de Serviço e debita a conta bancária que normalmente recebe seus repasses, no valor do saldo negativo na data em que o débito é iniciado.

A leitura prática: um conjunto de estornos em um mês de baixa receita não apenas reduz um repasse — pode tirar dinheiro da sua conta bancária. Contas com receita volátil ou com um padrão sazonal de picos e quedas devem acompanhar esse número de propósito, em vez de descobri-lo como um débito.

8. Etapa 6 — atenção às 48 horas voltadas ao usuário

A documentação voltada ao usuário do Google explica por que as disputas chegam aos bancos. A página Saiba mais sobre as políticas de reembolso do Google Play observa que as políticas de reembolso variam conforme o produto, o método de pagamento e a região, que a maioria dos apps no Play é feita por desenvolvedores terceiros e que o desenvolvedor pode processar reembolsos conforme suas próprias políticas e a lei aplicável — com a recomendação direta de que entrar em contato com o desenvolvedor costuma ser o caminho mais rápido para resolver um problema. A página Solicitar um reembolso no Google Play orienta os usuários a contatar o desenvolvedor quando querem um reembolso e já se passaram mais de 48 horas desde a compra. Usuários do EEE e do Reino Unido têm um caminho separado para compras feitas em ou após 28 de março de 2018.

A conclusão operacional não tem glamour: sua página de política de reembolso e um endereço de suporte acessível são infraestrutura de prevenção de chargeback. Um usuário que não consegue falar com você nos primeiros dois dias é um usuário cujo próximo passo é o banco — e, a partir de 3 de agosto de 2026, esse caminho é o que custa o valor mais uma taxa.

9. O que não fazer

  • Não revogue tudo em massa ao primeiro sinal. A Voided Purchases API é documentada como uma indicação de quando tomar medidas adicionais, e a própria orientação do Google pede uma política de revogação justa e transparente: avise os usuários quando você revogar o acesso a um produto dentro do app, dê a eles tempo para entender mudanças de política antes que entrem em vigor e permita que contestem suas decisões.
  • Não faça o reembolso sem a opção de revogação e espere que seu pipeline detecte isso. Apenas pedidos revogados aparecem na API.
  • Não trate a API como um livro-razão. Ela inclui estornos de processadora que outras fontes de pedidos omitem e exclui reembolsos que nunca foram reconhecidos em primeiro lugar.
  • Não o execute em uma agenda com a mesma duração da janela. Uma janela de 30 dias e um job mensal não têm margem para uma única execução com falha.

Gerencia contas de desenvolvedor em escala? Cuidamos do lado operacional.

Clique para escolher um arquivo · clique com o botão direito → Colar, ou pressione Ctrl/⌘+V para colar uma captura de tela

Você também pode arrastar um arquivo para esta caixa.

Respondemos ao e-mail que você fornecer. Seus dados ficam com KappS.

✔ Enviado

Recebemos sua mensagem e responderemos em até 24 horas.


← Voltar para editar