KappS Base de conhecimento · Blog

Compras de teste de cobrança no Google Play em 2026: tutorial passo a passo para testadores de licença

Blog Tutorial

O teste de licença do Google Play é o seguro mais barato que um app pago pode comprar, e é a etapa que a maioria das equipes pula. Antes que um único usuário pagante chegue à sua ficha, você pode fazer compras de teste reais pelo Play Billing, ver seu backend receber um token de compra real e acompanhar exatamente o que acontece quando um cartão é recusado — sem cobrar ninguém. Este tutorial percorre as três partes que os desenvolvedores vivem confundindo: testadores de licença (a lista no Play Console), instrumentos de teste (os métodos de pagamento que esses testadores veem no diálogo de compra) e Play Billing Lab (o app do Google que simula países, renovações e retenção de conta).

Um prazo entra na mesma frase, porque muda como você escreve os casos de teste: apps e atualizações precisam ser publicados com a Play Billing Library versão 8 ou superior, com um caminho de extensão até 1º de novembro de 2026. Um sandbox que valida o comportamento da versão 7 não vai dizer o que sua build de lançamento faz.

Etapa 1 · Decida qual sandbox você realmente precisa

Três configurações diferentes são chamadas de "teste", e cada uma responde a uma pergunta diferente. Escolha antes de pegar um dispositivo.

  • Teste com licença durante o desenvolvimento. Responde à pergunta "meu código de cliente trata a compra, o reconhecimento e o consumo?". Funciona com um build instalado por sideload, então você itera sem enviar nada. A própria documentação do Google observa que a Biblioteca de Faturamento normalmente é bloqueada para apps que não são assinados e enviados ao Play, e que os testadores com licença são isentos dessa verificação.
  • Uma faixa de teste mais testadores licenciados. Responde à pergunta "o build que a Google Play realmente entrega se comporta da mesma forma?". Use a faixa de teste interno para isso; é a faixa que a Google recomenda para trabalho de cobrança.
  • Uma faixa de teste com contas comuns do Google. Responde à pergunta "o cartão real de um desconhecido é aprovado e cobrado corretamente?". Essas compras custam dinheiro de verdade, e apps em rascunho e versões da faixa de teste interno estão sujeitos a limites de gastos.

Se você só executa a primeira configuração, está testando suas próprias suposições duas vezes. As três configurações são cumulativas, não alternativas.

Etapa 2 · Adicione os testadores no Play Console

  1. Abra o Play Console e acesse Configurações → Teste de licença.
  2. Adicione testadores como uma lista de e-mails ou como um Google Group. Uma lista de e-mails comporta até 2.000 endereços; um Google Group não tem limite de membros, e é por isso que agências com equipes de QA rotativas usam grupos.
  3. Salve as alterações. Sua própria conta de publicação é sempre tratada como testador licenciado, então a primeira pessoa que pode comprar é você.

Duas condições definem se o testador consegue de fato chegar ao produto, e elas costumam ser a causa do "o botão de compra está cinza":

  • O app precisa estar publicado nas faixas de teste aberto, teste fechado, teste interno ou produção — e o testador precisa estar apto a receber essa versão, ou seja, adicionado à faixa (ou ao Google Group dela) e inscrito pela URL de inscrição do teste.
  • Os produtos de pagamento único e as assinaturas que você quer testar precisam estar publicados. Produtos não publicados não existem no fluxo de compra, não importa como o testador esteja configurado.

Depois de publicar em uma faixa de teste, Google observa que pode levar algumas horas até que os testadores consigam instalar. Comece essa contagem no dia anterior à sessão de QA, não na manhã dela.

Etapa 3 · Colocar um build comprável no dispositivo do testador

Como os testadores de licença estão isentos da verificação de "assinado e enviado", você pode instalar uma compilação de depuração diretamente e ainda obter um diálogo de compra funcional. Há uma condição rígida: o nome do pacote deve corresponder ao app configurado no Play Console. Uma variante de depuração com sufixo .debug parece saudável e falha na hora do faturamento.

A conta importa tanto quanto o build. As contas de teste precisam estar no dispositivo do testador e, quando o dispositivo tem várias contas Google, a compra é feita com a conta que baixou o app — ou, se nenhuma delas o baixou, com a primeira conta do dispositivo. Expandir a caixa de diálogo de compra mostra qual conta está pagando, o que é a forma mais rápida de diagnosticar uma compra que cai no usuário errado.

Etapa 4 · Compre com os instrumentos de teste

Testadores com licença recebem métodos de pagamento de teste em vez de cartões reais. Dois deles concentram a maior parte do valor:

  • Instrumento de teste, sempre aprova — conclui a compra e retorna um token, para que você possa testar a entrega de direitos, a validação de recibos e o reconhecimento.
  • Instrumento de teste, sempre recusa — falha a cobrança, que é o caso que a maioria das integrações ignora até um usuário real esbarrar nele. Seu app deve mostrar um erro recuperável e deixar o usuário sem nada, não com um desbloqueio gratuito.

As compras de teste reutilizam o fluxo de compra comum, com duas diferenças que vale conhecer: os impostos não são calculados, e o diálogo exibe um aviso no centro marcando a compra como teste. Se você não vê esse aviso, não está em uma compra de teste — verifique a conta, não o código.

As assinaturas são onde os instrumentos de teste acabam. Uma renovação de teste não espera o seu período de cobrança real, então a lógica de renovação, período de tolerância e retenção de conta precisa dos recursos de aceleração do Play Billing Lab ou de uma simulação no servidor com tokens de compra gravados.

Etapa 5 · Confirme em até três minutos

A documentação da Google é incomumente específica nesse ponto: para compras feitas por testadores de licença, se o seu app não confirmar a compra, o pedido é reembolsado após três minutos e você recebe um e-mail sobre o cancelamento. Você pode confirmar o mesmo na aba Pedidos do Play Console.

Essa janela de três minutos é um recurso, não um incômodo. Ela transforma o reconhecimento em um teste visível: compre, encerre o app antes de reconhecer, espere e depois verifique Pedidos. Se o pedido sobreviver, seu caminho de reconhecimento está disparando em algum lugar que você não esperava — muitas vezes em um loop de nova tentativa que esconde uma chamada de servidor quebrada. O mesmo teste pega o bug oposto: consumir um produto não consumível, o que torna um produto comprável duas vezes quando não deveria.

Etapa 6 · Ensaie os estados críticos no Play Billing Lab

O Play Billing Lab é um app Android separado publicado pelo Google que fica entre o seu build de teste e o backend de faturamento. O que ele oferece, segundo a documentação do Google:

  • Altere o país do Play para o teste, assim você confere a exibição de preços regionais e a elegibilidade sem precisar mudar de país.
  • Repita o teste gratuito e as ofertas introdutórias na mesma conta — caso contrário, o benefício é de uso único e se esgota na primeira vez.
  • Teste alterações de preço de assinatura sem afetar outros assinantes ativos.
  • Acelere as transições de estado da assinatura: force uma renovação, mova a assinatura para o período de tolerância ou para o bloqueio da conta com uma única ação, em vez de esperar dias.
  • Use métodos de pagamento reais para contornar certos sinais de risco no fluxo de compra.
  • Teste compras fora do app para que seu backend processe transações que ele não viu serem iniciadas no app.

Três detalhes operacionais da mesma documentação, e todos custam uma tarde inteira se você aprender da forma difícil: entre no Play Billing Lab com a mesma conta que você usa para cobrança, essa conta precisa ser testadora de licença do app em teste, e a configuração expira após duas horas. Se uma alteração parecer não ser aplicada, entre novamente e tente de novo, e limpe o cache da Play Store no dispositivo que executa o teste.

Etapa 7 · Depois, quebre o sandbox de propósito

A última execução é a que as equipes esquecem: repita a compra com uma conta que não seja de testador de licença. Testadores de licença recebem um comportamento ajustado para testes — as durações de renovação são o exemplo óbvio —, então um app que só encontrou testadores de licença pode publicar uma lógica que depende silenciosamente do ambiente de teste. O Google recomenda testes ocasionais com contas comuns exatamente por isso, e após grandes mudanças de cobrança.

Reserve orçamento para isso, porque essas compras são cobranças reais e os reembolsos são um fluxo de suporte, não um botão. Faça-as em um produto de baixo preço, guarde os IDs dos pedidos e reembolse deliberadamente pelo Play Console em vez de pedir ao usuário que abra uma disputa.

As seis falhas que respondem pela maior parte disso

  1. Nome do pacote divergente. A variante de debug instala e cobra com um applicationId diferente do que está no Play Console; o faturamento falha sem nenhuma mensagem útil.
  2. Produto não publicado. O teste de licença está configurado, o testador foi adicionado, e o SKU ainda não aparece porque o produto único ou a assinatura nunca foi ativado.
  3. Testador não está na faixa. Teste de licença e participação na faixa são listas separadas. Estar em uma não coloca você na outra.
  4. Conta Google errada no dispositivo. A compra vai para a conta que baixou o app, ou para a primeira conta quando ninguém o fez.
  5. Compra não reconhecida reembolsada após três minutos. Normalmente é uma chamada de servidor ausente, às vezes uma exceção engolida por um wrapper de nova tentativa.
  6. Só testadores de licença foram testados. A versão funciona no sandbox e falha para usuários pagantes, porque nada exercitou o caminho de não testador.

Fontes: Play Console Help, "Test in-app billing with application licensing" (listas de testadores de licença, produtos publicados, elegibilidade da faixa de teste) e Android Developers, "Test your Google Play Billing Library integration" (isenção de sideload, instrumentos de teste, a regra de reembolso de três minutos, recursos do Play Billing Lab e a expiração de configuração em duas horas). O Google não publica limites de aceitação para sinais de risco de cobrança; nenhum é inferido aqui.

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