As permissões da conta de serviço do Google Play decidem quem pode reembolsar seus pedidos, então conceda o conjunto mínimo que funcione
Uma única permissão do Play Console deixa uma conta de serviço reembolsar qualquer pedido e cancelar qualquer assinatura. Veja quais permissões da conta de serviço do Google Play uma ferramenta de reembolso realmente precisa, o que uma chave vazada pode fazer em cada loja e como limitar, rotacionar e revogar as chaves.

Principais conclusões
- A permissão Manage orders and subscriptions (gerenciar pedidos e assinaturas) do Google Play permite ver pedidos, reembolsar pedidos e cancelar assinaturas, então qualquer conta de serviço que a tenha pode devolver dinheiro aos seus compradores.
- O guia da Google Play Developer API diz que as APIs de faturamento do Google Play precisam de duas permissões do Play Console: View financial data, orders, and cancellation survey responses, e Manage orders and subscriptions.
- O método orders.refund da Google Play Developer API pode reembolsar qualquer pedido de compra única ou de assinatura com até 3 anos e, com revoke definido como true, encerra o acesso do comprador na hora.
- As chaves de contas de serviço do Google Cloud não expiram por padrão, e o Google diz que uma chave enviada a um repositório de código precisa ser excluída no IAM, porque removê-la do repositório não basta.
- A In-App Purchase key da Apple não emite reembolsos, mas pode chamar a App Store Server API, inclusive os endpoints que estendem a data de renovação de assinaturas em até 90 dias, uma extensão que, segundo a Apple, não pode ser desfeita.
- Só um Account Holder ou um Admin pode gerar uma In-App Purchase key no App Store Connect, a chave privada é baixada uma única vez e uma chave revogada não pode ser restabelecida.
Dê a uma conta de serviço duas permissões do Play Console e ela poderá reembolsar qualquer pedido do seu app. Isso não é erro de configuração. É exatamente assim que o Google projetou a Google Play Developer API, e é por isso que a chave JSON por trás da sua ferramenta de reembolso merece o mesmo cuidado que o login do seu banco.
A maioria das equipes configura isso uma vez, com prazo apertado, marcando o que fez a primeira chamada de API funcionar. Este guia faz o caminho inverso. Ele mostra quais permissões da conta de serviço do Google Play o trabalho com reembolsos e chargebacks realmente exige, o que cada loja deixa uma chave roubada fazer e como manter o raio de impacto pequeno.
O que as permissões da conta de serviço do Google Play realmente permitem
Uma conta de serviço é um usuário robô. Você a cria no Google Cloud e depois convida o e-mail dela no Play Console, em Users and permissions (usuários e permissões), do mesmo jeito que convidaria um colega. A partir daí ela pode fazer tudo o que essas permissões permitem, pela API, a qualquer hora, sem segundo fator.
As duas permissões que as APIs de faturamento exigem
O guia da Google Play Developer API é específico. Para usar as APIs de faturamento do Google Play, você concede duas permissões: View financial data, orders, and cancellation survey responses (ver dados financeiros, pedidos e respostas da pesquisa de cancelamento), e Manage orders and subscriptions (gerenciar pedidos e assinaturas). A primeira deixa a conta ler pedidos e usar a API de compras. A segunda é a que mexe com dinheiro.
| Permissão do Play Console | O que o Google diz que ela permite | Pode devolver dinheiro aos compradores? |
|---|---|---|
| View financial data, orders, and cancellation survey responses | Ver relatórios financeiros, relatórios de vendas e pedidos, acessar a API de compras, baixar respostas da pesquisa de cancelamento | Não |
| Manage orders and subscriptions | Ver pedidos, reembolsar pedidos, cancelar assinaturas | Sim |
| Admin (todas as permissões) | Todas as outras permissões, além de convidar usuários e alterar as permissões deles | Sim, e pode conceder mais a si mesma |
O que uma chave com direito a reembolso pode fazer
O método orders.refund da Google Play Developer API reembolsa o pedido de uma assinatura ou de uma compra no app. O Google diz que pedidos com mais de 3 anos não podem ser reembolsados, o que significa que todos os mais recentes podem. Defina revoke como true e o acesso do comprador termina na hora. Para assinaturas, purchases.subscriptionsv2.revoke com reembolso total faz o mesmo.
Essas são as ferramentas certas quando você quer usá-las. As próprias orientações antifraude do Google mandam reembolsar e revogar uma compra que falha nas suas verificações em vez de deixá-la expirar. O problema é uma chave que pode fazer isso em todos os apps da sua conta quando só precisava de um.
Quanto uma chave vazada pode custar em dinheiro
Faça as contas antes de decidir quanto esforço isso merece. No Google Play, uma chave com Manage orders and subscriptions pode reembolsar pedidos uma chamada de cada vez, e cada reembolso devolve a venda ao comprador. Um script não se cansa. O teto é o seu histórico de pedidos dos últimos 3 anos.
Os custos que não voltam com o reembolso
Um reembolso desfaz a venda. Ele não desfaz o que você gastou para atendê-la. Esse gasto fica nos seus livros, seja o reembolso escolha de um cliente ou de um invasor.
- Processamento já executado: tempo de GPU e de servidor por trás de cada geração, renderização ou resposta de modelo que o comprador recebeu.
- Chamadas de API já pagas: cobranças por requisição de provedores de modelos, mapas, voz ou dados.
- Armazenamento que você continua pagando: os arquivos e o histórico que essas contas ainda guardam nos seus servidores.
- Repasses já enviados: repasses a criadores, afiliados ou vendedores ligados a essas compras não voltam com o reembolso.
Do lado da Apple, o risco tem outro formato
A App Store Server API da Apple não tem nenhum endpoint que emita reembolso. Quem decide os reembolsos é a Apple. Mas a mesma In-App Purchase key pode estender a data de renovação de um assinante em até 90 dias, duas vezes a cada 365 dias por cliente, ou para todos os assinantes ativos de um produto numa única requisição em massa. A Apple diz que uma extensão não pode ser desfeita. Nesses dias, o assinante não é cobrado e continua usando seu app, então suas contas de processamento, armazenamento e API continuam correndo sem receita.
| O que uma chave roubada pode fazer | Conta de serviço do Google Play com Manage orders and subscriptions | In-App Purchase key da Apple |
|---|---|---|
| Reembolsar um pedido | Sim, pedidos com até 3 anos | Não, só a Apple reembolsa |
| Encerrar o acesso de um comprador | Sim, com revoke no reembolso | Não |
| Cancelar ou estender assinaturas | Cancelar, sim | Estender datas de renovação em até 90 dias, de forma irreversível |
| Ler dados de compras | Sim, com a permissão de visualização | Sim, histórico de transações e reembolsos |
| Responder a análises de reembolso | Sim, orders.reviewrefund | Sim, Send Consumption Information |
| Limitar a um app | Sim, com permissões de app | Não, a chave vale para todos os apps da sua equipe |
Como limitar as permissões da conta de serviço do Google Play
O Play Console separa permissões de conta de permissões de app. As permissões de app valem só para os apps que você selecionar. Essa única configuração faz mais pela sua segurança do que qualquer outro item desta lista.
Conceda em um app, não na conta inteira
Convide cada conta de serviço com permissões de app nos apps que ela atende. Uma ferramenta de reembolso para um jogo não precisa de direito de reembolso no seu app de meditação. Uma armadilha: View financial data, orders, and cancellation survey responses só existe no nível da conta, e o equivalente no nível do app se chama View financial data. Escolha a de nível de app ao limitar.
Separe leitura de reembolso
Nem toda tarefa precisa de Manage orders and subscriptions. Análises que só leem pedidos podem rodar numa conta com permissão de visualização e nada mais. Deixe a chave capaz de reembolsar apenas no serviço que realmente chama orders.refund, orders.reviewrefund ou os endpoints de revoke.
Nunca dê Admin a um robô
Admin concede todas as permissões, e o Google lista entre seus direitos convidar usuários e gerenciar as permissões deles. Uma chave Admin vazada pode ampliar o próprio acesso ou convidar alguém novo. Nenhum fluxo de reembolso precisa disso.
Pergunte aos fornecedores como eles se conectam
Algumas ferramentas pedem que você envie uma chave JSON. Outras fornecem o e-mail da própria conta de serviço para você convidar, assim nenhuma chave sua sai do seu controle e você pode remover o acesso delas em Users and permissions com um clique. Se um fornecedor precisa de direito de reembolso, pergunte quais permissões, em quais apps e por quê.

Como guardar, rotacionar e revogar as chaves
As duas lojas dizem a mesma coisa com palavras diferentes. Não coloque chaves num repositório de código nem as inclua no seu app. As diferenças estão no que acontece depois que algo dá errado.
Chaves do Google Cloud não expiram sozinhas
As orientações do Google Cloud observam que chaves de contas de serviço não têm data de expiração por padrão. Elas recomendam rotacioná-las com frequência e desativar as que você não usa mais. Se uma chave for parar num repositório, o Google diz para excluí-la no IAM o mais rápido possível, porque apagá-la do repositório não basta. O Google Cloud também pode desativar automaticamente chaves vazadas que detectar quando a restrição Service Account Key Exposure Response está definida como DISABLE_KEY, mas não garante que vai pegar todos os vazamentos.
Chaves da Apple são baixadas uma vez e revogadas para sempre
Só um Account Holder ou um Admin pode gerar uma In-App Purchase key. A Apple guarda a parte pública, você baixa o arquivo privado .p8 uma única vez e a Apple não guarda cópia. Se suspeitar que uma chave foi comprometida, a Apple diz para revogá-la imediatamente no App Store Connect, em Users and Access, Integrations, In-App Purchase. Uma chave revogada não pode ser restabelecida, e revogá-la também impede o resgate de ofertas promocionais assinadas com ela, então atualize essas ofertas antes ou logo depois.
| Tarefa | Conta de serviço do Google Play | In-App Purchase key da Apple |
|---|---|---|
| Quem pode criar | Criada no Google Cloud e depois convidada em Users and permissions do Play Console | Account Holder ou Admin |
| Dá para baixar o segredo de novo? | Você cria uma chave nova | Não, um único download |
| Expiração padrão | Nenhuma | Nenhuma, até você revogar |
| Como cortar o acesso rápido | Excluir a chave no IAM ou remover a conta no Play Console | Revogar a chave no App Store Connect |
| Efeitos colaterais de cortar o acesso | Qualquer ferramenta que use essa conta para de chamar a API | Ofertas promocionais assinadas com ela deixam de ser resgatadas |
Um checklist curto
- Uma conta de serviço por tarefa, convidada com permissões de app só nos apps que ela atende.
- Manage orders and subscriptions só na conta que realmente reembolsa, revoga ou responde a análises.
- Nenhum Admin em conta robô.
- Chaves num gerenciador de segredos, nunca num repositório, num log de build ou num app mobile.
- Uma lista escrita de cada chave, quem a criou e qual serviço a usa, para que uma revogação não quebre suas respostas de reembolso.
- Uma revisão de Users and permissions no Play Console e das chaves do App Store Connect sempre que alguém sai da equipe ou um fornecedor é dispensado.
Perguntas frequentes
- De quais permissões do Play Console uma conta de serviço precisa para reembolsos e chargebacks?
- Ela precisa de Manage orders and subscriptions para reembolsar pedidos, cancelar assinaturas e trabalhar com pedidos, além de acesso de visualização aos pedidos. O guia da Google Play Developer API lista View financial data, orders, and cancellation survey responses e Manage orders and subscriptions como as duas permissões que as APIs de faturamento do Google Play exigem.
- Uma conta de serviço do Google Play pode reembolsar pedidos?
- Sim, se tiver a permissão Manage orders and subscriptions. A página de ajuda do Google diz que essa permissão deixa ver pedidos, reembolsar pedidos e cancelar assinaturas, e o método orders.refund da API reembolsa qualquer pedido com até 3 anos.
- Alguém com minha In-App Purchase key da App Store pode reembolsar meus clientes?
- Não. A App Store Server API não tem endpoint de reembolso, porque quem decide os reembolsos é a Apple. Mesmo assim, uma chave roubada pode ler o histórico de transações e reembolsos, enviar informações de consumo e estender datas de renovação de assinaturas em até 90 dias, o que, segundo a Apple, não pode ser desfeito.
- As chaves de contas de serviço do Google Play expiram?
- Não por padrão. As orientações do Google Cloud dizem que as chaves que você cria e baixa não têm data de expiração a menos que você configure uma, e recomendam rotacionar as chaves com frequência e desativar as que não usa mais.
- O que fazer se a chave JSON da minha conta de serviço foi enviada ao GitHub?
- Exclua a chave no IAM do Google Cloud imediatamente e crie uma nova. O Google diz que remover a chave do repositório não basta, porque qualquer pessoa que a copiou ainda pode usá-la até que a própria chave seja excluída.
Fontes e leituras adicionais
- Play Console Help: Add developer account users and manage permissions
- Google Play Developer API: Getting started (service accounts and required permissions)
- Google Play Developer API: orders.refund reference
- Android Developers: Fight fraud and abuse
- Google Cloud: Best practices for managing service account keys
- Apple Developer: Creating API keys to authorize API requests
- App Store Connect Help: Generate keys for in-app purchases
- Apple Developer: Extending the renewal date for auto-renewable subscriptions
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.