Todos os artigos
Playbook7 min de leitura

Você pode reembolsar um pedido do Google Play por conta própria, e fazer isso antes de um chargeback economiza a tarifa bancária

Você pode reembolsar qualquer pedido do Google Play com menos de três anos com uma única chamada de API, com ou sem revogar o acesso. Fazer isso você mesmo antes de uma disputa virar chargeback economiza a tarifa bancária que recai sobre os desenvolvedores a partir de 3 de agosto de 2026. Veja como orders.refund funciona.

Uma mesa de desenvolvedor ao anoitecer com um celular exibindo um painel de gestão de pedidos, ilustrando como reembolsar você mesmo um pedido do Google Play

Principais conclusões

  • O endpoint `orders.refund` da Google Play Developer API permite que um desenvolvedor reembolse diretamente qualquer compra única ou pedido de assinatura, sem revisão, sem motivo exigido e sem precisar de uma solicitação do cliente.
  • Um reembolso e uma revogação são ações distintas. `orders.refund` aceita um sinalizador opcional `revoke`. Deixe-o desligado e o comprador mantém o acesso; defina como true e o Google encerra o acesso ao item imediatamente.
  • Pedidos com mais de três anos não podem ser reembolsados pela Google Play Developer API. Uma vez que essa janela se fecha, o pedido fica permanentemente fora de alcance.
  • `orders.refund` emite apenas reembolsos totais. Um reembolso parcial e proporcional de uma assinatura exige o endpoint mais novo `purchases.subscriptionsv2.revoke` com um contexto `proratedRefund`.
  • Reembolsar um pedido de assinatura com `revoke` definido como true dispara uma Real-time Developer Notification `SUBSCRIPTION_REVOKED`, de modo que seu backend fica sabendo da revogação da mesma forma que sabe de qualquer outro evento de assinatura.
  • A partir de 3 de agosto de 2026, o Google cobra do desenvolvedor o preço de compra mais as tarifas bancárias de um chargeback. Um reembolso que você mesmo emite devolve apenas o preço de compra, então reembolsar cedo um pedido duvidoso pode ser mais barato do que deixá-lo virar um chargeback.
  • Um reembolso iniciado pelo desenvolvedor é o único fluxo de reembolso do Google Play que você controla por completo. O reembolso de autoatendimento de 48 horas, os reembolsos de suporte e as compras anuladas são todos decididos sem você.

Você não precisa esperar um cliente abrir uma disputa. Se quiser devolver o dinheiro, você pode reembolsar um pedido do Google Play por conta própria, diretamente, com uma única chamada de API ou dois cliques no Play Console. O Google não vai perguntar por quê, e não vai questionar você. Este é o único fluxo de reembolso em que você segura o botão, e usá-lo cedo, antes de uma disputa endurecer até virar um chargeback bancário, costuma ser a saída mais barata.

O único fluxo de reembolso que você realmente controla

A maioria dos reembolsos no Google Play acontece com você, não por meio de você. Um comprador que pede ao Google dentro de 48 horas recebe um reembolso de autoatendimento automático sem participação do desenvolvedor. Um agente de suporte pode conceder um que é definitivo no momento em que é emitido. Um chargeback bancário é decidido entre o titular do cartão e o banco dele. Em todos esses casos, você é um espectador que descobre depois.

O reembolso do desenvolvedor é a exceção. Aqui é você quem decide devolver o dinheiro, no seu próprio ritmo, pelos seus próprios motivos. É uma ferramenta de boa vontade, uma ferramenta de atendimento ao cliente e, discretamente, uma ferramenta de controle de custos. Saber exatamente como ele se comporta é o que o transforma de um botão de pânico em uma escolha deliberada.

O que orders.refund faz, em uma chamada

O método orders.refund da Google Play Developer API reembolsa um único pedido, seja esse pedido uma compra única no app ou um pagamento de assinatura. Você envia um POST vazio para o caminho de reembolso do pedido, autenticado com sua conta de serviço, e uma chamada bem-sucedida retorna um corpo vazio. Esse é todo o mecanismo.

O sinalizador revoke decide se eles mantêm o acesso

A única escolha que a chamada oferece é o sinalizador de consulta revoke. A referência do Google é direta sobre o que ele faz: se definido como true, o acesso à assinatura ou ao item no app será encerrado imediatamente. Omita-o e o dinheiro volta enquanto o cliente mantém o que comprou. Esse único booleano é a diferença entre um reembolso amigável e um cancelamento limpo.

Parte da chamadaValor
Método e caminhoPOST /androidpublisher/v3/applications/{packageName}/orders/{orderId}:refund
packageNameO id do seu app, por exemplo com.acme.app
orderIdO id do pedido mostrado ao comprador na compra
revokeSinalizador de consulta opcional. true encerra o acesso imediatamente; omita-o para reembolsar e deixar o acesso intacto
Corpo da requisiçãoVazio
Escopo OAuthhttps://www.googleapis.com/auth/androidpublisher

Reembolso total por padrão, proporcional apenas para assinaturas

orders.refund devolve o valor total do pedido. Ele não tem campo para um valor parcial. Se você precisar devolver parte de uma assinatura, recorra ao endpoint mais novo purchases.subscriptionsv2.revoke, que aceita um contexto de revogação e pode emitir um reembolso total ou um proporcional com base no tempo restante no período. O antigo purchases.subscriptions.revoke fazia apenas reembolsos totais, que é o principal motivo de o método v2 existir. Para pedidos únicos, reembolsos parciais estão disponíveis pelo site do Play Console para compras feitas depois de março de 2018, e nunca para apps pagos.

Um único recibo de papel apoiado ao lado de um cartão de crédito, representando um reembolso do Google Play emitido pelo próprio desenvolvedor

A barreira dos três anos e outros limites

O limite rígido é a idade. O Google afirma claramente que pedidos com mais de três anos não podem ser reembolsados. Não há recurso nem exceção depois que um pedido cruza essa linha, então um reembolso é uma decisão com prazo de validade. Um punhado de outros limites molda o que a chamada pode e não pode fazer.

LimiteO que significa
Teto de idade de três anosPedidos com mais de três anos não podem ser reembolsados pela API
Apenas valor totalorders.refund devolve o valor total do pedido, nunca um valor parcial
Reembolsos parciaisDisponíveis para assinaturas via purchases.subscriptionsv2.revoke, ou pelo Play Console para pedidos únicos feitos depois de março de 2018, nunca para apps pagos
Não reversívelUma vez emitido, um reembolso não pode ser desfeito

O que isso economiza para você em dinheiro

Todo reembolso já é um prejuízo antes de você tocar no botão, porque o dinheiro que você gastou para atender aquela compra não volta com ele. Se o comprador gerou imagens, executou chamadas de API contra seus modelos, consumiu armazenamento ou disparou um pagamento a terceiros, esses custos estão gastos e continuam gastos. O reembolso só decide quem fica com o preço da venda além disso.

O motivo para recorrer você mesmo a um reembolso é o que acontece se você não fizer. A documentação do Google é explícita: a partir de 3 de agosto de 2026, quando um cliente contesta uma cobrança com o banco, o Google repassa o preço de compra e a tarifa de chargeback do banco ao desenvolvedor. Um reembolso que você emite por orders.refund devolve apenas o preço de compra. Então, para um pedido que você já espera perder, um reembolso emitido por você é mais barato que o chargeback exatamente pela tarifa bancária, e encerra o caso antes que ele possa escalar.

Onde um autorreembolso se encaixa entre os outros fluxos de reembolso

Ajuda ver o reembolso do desenvolvedor ao lado de tudo o mais que pode retirar dinheiro da sua conta. Apenas dois desses fluxos chegam a pedir a sua participação, e apenas um deles deixa você iniciar o reembolso por conta própria.

Fluxo de reembolsoQuem decideSeu controle
Reembolso do desenvolvedor (orders.refund)VocêTotal. Você escolhe se e quando
Reembolso de autoatendimento de 48 horasGoogleNenhum. O Google reembolsa automaticamente
Reembolso de agente de suporteSuporte do Google ou da AppleNenhum. Definitivo uma vez concedido
Revisão de chargeback (orders.reviewrefund)Google, usando suas provasApenas uma janela de participação de 24 horas
Voided Purchases APINinguém, é somente leituraNenhum. Você só lê o que já aconteceu

Como reembolsar um pedido do Google Play, do início ao fim

Pelo Play Console

  • Abra o Play Console e selecione Gestão de pedidos no menu à esquerda.
  • Encontre o pedido pelo id do pedido ou pelo endereço de e-mail completo do comprador.
  • Abaixo do preço, escolha Reembolsar e selecione um motivo de reembolso. Use o site, não o app móvel, se precisar de um reembolso parcial.

Pela API

  • Autentique uma conta de serviço que tenha o escopo androidpublisher e permissões financeiras no Play Console.
  • Envie um POST vazio para o caminho de reembolso do pedido, adicionando revoke=true apenas se você também quiser cortar o acesso.
  • Trate a resposta de sucesso vazia e, se você revogou uma assinatura, espere uma notificação SUBSCRIPTION_REVOKED chegar ao seu backend.

Um reembolso do desenvolvedor é um instrumento pequeno e afiado. Ele dá a você uma forma limpa de compensar um cliente, e uma saída mais barata que um chargeback em um pedido que você ia perder de qualquer jeito. A única regra é usá-lo de propósito, com o sinalizador revoke definido do jeito que você realmente quer.

Perguntas frequentes

Posso reembolsar um pedido do Google Play sem cancelar o acesso do cliente?
Sim. Chame `orders.refund` e deixe o sinalizador `revoke` desligado. O comprador recebe o dinheiro de volta e mantém o acesso ao item. Defina `revoke` como true apenas quando você também quiser encerrar o acesso à compra imediatamente.
Até quando posso reembolsar um pedido no Google Play?
Até três anos a partir da data da compra. A Google Play Developer API afirma que pedidos com mais de três anos não podem ser reembolsados, e não há exceção depois que essa janela se fecha.
orders.refund suporta reembolsos parciais?
Não. `orders.refund` emite apenas o valor total do pedido. Para um reembolso parcial ou proporcional de uma assinatura, use `purchases.subscriptionsv2.revoke` com um contexto `proratedRefund`, ou emita um reembolso parcial pelo Play Console para pedidos únicos elegíveis.
Meu backend vai saber quando eu revogar uma assinatura com um reembolso?
Sim. Reembolsar um pedido de assinatura com `revoke` definido como true dispara uma Real-time Developer Notification `SUBSCRIPTION_REVOKED`, de modo que seu servidor pode atualizar o direito de acesso da mesma forma que lida com qualquer outro evento de assinatura.
É melhor reembolsar um pedido eu mesmo do que deixá-lo virar um chargeback?
Muitas vezes, em termos puros de custo. A partir de 3 de agosto de 2026 um chargeback custa ao desenvolvedor o preço de compra mais a tarifa bancária, enquanto um reembolso que você emite devolve apenas o preço de compra. Se um pedido está claramente indo para uma disputa, reembolsá-lo cedo evita a tarifa bancária adicional.

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.