Todos os artigos
Guia prático8 min de leitura

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.

Uma chave de latão sobre uma mesa escura ao lado de um notebook e um celular, representando as permissões da conta de serviço do Google Play que controlam os reembolsos

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 ConsoleO que o Google diz que ela permitePode devolver dinheiro aos compradores?
View financial data, orders, and cancellation survey responsesVer relatórios financeiros, relatórios de vendas e pedidos, acessar a API de compras, baixar respostas da pesquisa de cancelamentoNão
Manage orders and subscriptionsVer pedidos, reembolsar pedidos, cancelar assinaturasSim
Admin (todas as permissões)Todas as outras permissões, além de convidar usuários e alterar as permissões delesSim, 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 fazerConta de serviço do Google Play com Manage orders and subscriptionsIn-App Purchase key da Apple
Reembolsar um pedidoSim, pedidos com até 3 anosNão, só a Apple reembolsa
Encerrar o acesso de um compradorSim, com revoke no reembolsoNão
Cancelar ou estender assinaturasCancelar, simEstender datas de renovação em até 90 dias, de forma irreversível
Ler dados de comprasSim, com a permissão de visualizaçãoSim, histórico de transações e reembolsos
Responder a análises de reembolsoSim, orders.reviewrefundSim, Send Consumption Information
Limitar a um appSim, com permissões de appNã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ê.

Uma desenvolvedora à mesa revogando um acesso no notebook, com uma fileira de chaves em ganchos na parede e um gancho vazio, ilustrando como remover permissões da conta de serviço do Google Play

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.

TarefaConta de serviço do Google PlayIn-App Purchase key da Apple
Quem pode criarCriada no Google Cloud e depois convidada em Users and permissions do Play ConsoleAccount Holder ou Admin
Dá para baixar o segredo de novo?Você cria uma chave novaNão, um único download
Expiração padrãoNenhumaNenhuma, até você revogar
Como cortar o acesso rápidoExcluir a chave no IAM ou remover a conta no Play ConsoleRevogar a chave no App Store Connect
Efeitos colaterais de cortar o acessoQualquer ferramenta que use essa conta para de chamar a APIOfertas 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

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.