Teste sua integração durante o desenvolvimento. Para testar durante a fase de desenvolvimento, recomendamos utilizar testadores de licença e Play Faturamento Lab para executar os cenários descritos nesta seção.
Testadores de licença
Para configurar testadores de licença, consulte Testar o faturamento em apps com o licenciamento de apps.
O uso de testadores de licença oferece os seguintes benefícios:
- Normalmente, a biblioteca do Google Play Faturamento é bloqueada para apps que não são assinados e enviados ao Google Play. Os testadores de licença podem ignorar essa verificação, o que significa que é possível transferir apps por sideload para testes, mesmo apps que usam builds de depuração com assinaturas de depuração, sem precisar fazer upload para a nova versão do app. O nome do pacote precisa corresponder ao do app configurado para o Google Play. Além disso, a Conta do Google precisa ser um testador de licença da conta do Google Play Console.
- Os testadores de licença têm acesso a formas de pagamento de teste que não cobram deles o valor real das compras. Também é possível usar formas de pagamento de teste para simular determinadas situações, como quando um pagamento é recusado. A Figura 1 mostra essas formas de pagamento de teste na ordem em que aparecem no fluxo de compra.
- Os testadores de licença podem testar rapidamente os recursos de assinatura.
![Os testadores de licença têm acesso a formas de pagamento de teste](https://developer.android.com/static/images/google/play/billing/test-payment-methods.png?authuser=6&hl=pt)
Veja mais detalhes sobre o processo de compra de teste:
- As compras de teste usam o mesmo fluxo de compra no aplicativo usado no processo real.
- Não são calculados impostos para compras de teste.
- O Google Play indica uma compra de teste exibindo um aviso no centro da caixa de diálogo de compras.
Você pode confirmar qual conta está fazendo a operação expandindo a caixa de diálogo da compra. Observe o seguinte:
- As contas de teste precisam estar no dispositivo Android do testador.
- Se o dispositivo tiver mais de uma conta, a compra será realizada com aquela que fez o download do app.
- Se nenhuma das contas tiver feito o download, a compra será realizada com a primeira conta.
Antes de distribuir seu app, use as faixas de teste do Google Play para realizar uma validação adicional. Por exemplo, é possível aproveitar as faixas de teste para que sua equipe de controle de qualidade qualifique um lançamento.
Com as faixas de teste, os usuários podem instalar seu app pelo Google Play e testar uma versão que ainda não está disponível publicamente. Os usuários podem fazer compras reais usando qualquer forma de pagamento no Google Play.
Para testar a integração da Biblioteca Play Faturamento usando faixas de teste, faça o seguinte:
- Publique seu app em uma faixa de teste. Após a publicação de um app em uma faixa de teste, pode levar algumas horas até que ele fique disponível para os testadores.
- Verifique se cada testador aceitou o teste do seu aplicativo. No URL de ativação do teste, os testadores veem uma explicação do que significa ser um testador, junto a um link de ativação.
É possível testar sua integração em qualquer dispositivo de hardware com Android 1.6 ou versões mais recentes. É necessário que a versão mais recente do aplicativo Google Play esteja instalada no dispositivo. Para ter informações gerais sobre como configurar um dispositivo para uso no desenvolvimento de aplicativos para Android, consulte Uso de dispositivos de hardware.
Laboratório do Play Faturamento
O Laboratório de faturamento do Google Play é um app Android que ajuda os desenvolvedores a testar integração com o sistema de faturamento do Google Play. Ele oferece uma maneira fácil e forma conveniente para os desenvolvedores testarem recursos de faturamento, integrarem-se mais rapidamente e lançar com mais confiança. Você pode fazer o download e instalar do Google Play Faturamento Play Store:
Com o Play Billing Lab, é possível fazer o seguinte nos seus testes:
- Mudar o país do Google Play no Play Billing Lab e aplicar as configurações ao teste. Isso permite testar experiências do usuário personalizadas em diferentes países/regiões independentemente de onde o testador está fisicamente
- Testes de teste ou ofertas iniciais repetidamente com os mesmos conta
- Testar as mudanças no preço da assinatura sem afetar outros inscritos ativos
![Painel do laboratório de faturamento do Google Play](https://developer.android.com/static/images/google/play/billing/play-billing-lab-dashboard.png?authuser=6&hl=pt)
Testar produtos de aquisição única
Testar produtos de consumo
Ao testar produtos de consumo, recomendamos o teste de uma variedade de situações, incluindo o seguinte:
- Uma compra bem-sucedida em que o usuário recebe um item. Com um testador de licença, você pode usar a forma de pagamento Instrumento de teste, aprovado sempre.
- Uma compra em que a forma de pagamento falhou ao receber a cobrança e o usuário não receberá o item. Com um testador de licença, você pode usar a forma de pagamento Instrumento de teste, recusado sempre.
- Verifique se os itens podem ser comprados várias vezes.
Verifique também se as compras são reconhecidas corretamente, conforme descrito em Processamento de compras. As compras de testadores de licença serão reembolsadas após três minutos se o app não as confirmar, e você receberá um e-mail sobre o cancelamento. Você também pode verificar a guia Pedidos no Google Play Console para ver se um pedido foi reembolsado após três minutos.
Testar produtos que não são de consumo
Os itens que não são de consumo precisam ser testados da mesma forma que os de consumo, mas é preciso verificar se um item não pode ser comprado novamente dentro do app. Verifique a confirmação da compra para produtos que são ou não de consumo (quando aplicável), já que a lógica para processar cada um dos dois tipos de compra varia.
Testar compras pendentes
Teste uma compra pendente em que o item precisa ser concedido quando
o estado da compra se torna PURCHASED
. Os testadores de licença têm acesso a dois
instrumentos de teste para formas de pagamento atrasadas em que o pagamento é concluído ou
cancelado automaticamente após alguns minutos.
Faça uma compra com uma forma de pagamento atrasada "Cartão de teste lento recusado após alguns minutos", conforme mostrado na Figura 2. Reinicie o app e confirme se a compra não foi concedida.
Figura 3. Faça uma compra com um cartão de teste lento recusado. Faça uma compra com uma forma de pagamento atrasada "Cartão de teste lento aprovado após alguns minutos", conforme mostrado na Figura 3. Aguarde alguns minutos e confirme se a compra foi concedida.
Figura 4. Faça uma compra com um cartão de teste lento aprovado.
Saiba mais em Como processar transações pendentes.
Testar recursos específicos de assinaturas
Os fluxos de compra para produtos e assinaturas de aquisição única são semelhantes, mas as assinaturas têm outras situações, como renovações de assinatura aprovadas ou recusadas. Para testar renovações, use as formas de pagamento Instrumento de teste, aprovado sempre e Instrumento de teste, recusado sempre, disponíveis para testadores de licença, conforme mostrado na Figura 1. Use esses instrumentos de pagamento para testar situações além da assinatura aprovada.
Assim como nos produtos únicos, é necessário verificar também se as compras foram confirmadas corretamente, conforme descrito em Como processar compras. As compras de testadores de licença serão reembolsadas após três minutos se o app não as confirmar, e você receberá um e-mail sobre o cancelamento. Você também pode conferir a guia "Pedidos" no Google Play Console para saber se um pedido foi reembolsado após três minutos.
Períodos de renovação
As assinaturas de teste são renovadas mais rapidamente do que as assinaturas reais. as assinaturas de teste podem ser renovadas no máximo seis vezes, sem contar o valor sem custo financeiro testes e períodos introdutórios.
A tabela a seguir lista os tempos de renovação de teste para assinaturas de várias durações. Os tempos são aproximados. Você pode notar pequenas variações no tempo exato de um evento. Para compensar a variação, chame a API para visualizar o status atual após cada data de validade de assinatura.
Período de assinatura de produção | Renovação de assinatura de teste |
1 semana | 5 minutos |
1 mês | 5 minutos |
3 meses | 10 minutos |
6 meses | 15 minutos |
1 ano | 30 minutos |
Recursos de assinatura baseados em tempo, como períodos de testes sem custo financeiro, também são reduzidos no teste. A tabela a seguir identifica os períodos de teste associados aos recursos de assinatura baseados em tempo:
Recurso | Período de teste |
Confirmação da compra | 5 minutos |
Teste sem custo financeiro | 3 minutos |
Período de preço inicial | Igual ao período de teste de assinatura |
Período de carência (três e sete dias) | 5 minutos |
Suspensão de conta | 10 minutos |
Pausa (1 mês) | 5 minutos |
Pausa (2 meses) | 10 minutos |
Pausa (3 meses) | 15 minutos |
Ofertas de teste
Com o recurso de teste da oferta de teste do Laboratório de faturamento do Google Play, O testador de licença pode testar e usar teste sem custo financeiro ou ofertas introdutórias número de vezes marcando a opção Teste sem custo financeiro ou oferta introdutória e aplicando a alteração. Isso elimina a necessidade de criar vários para testar uma oferta de teste disponível apenas para novos assinantes.
![ofertas de teste de teste](https://developer.android.com/static/images/google/play/billing/trial-offers-testing.png?authuser=6&hl=pt)
Mudanças no preço
Você também pode usar o Laboratório de faturamento do Google Play e testadores de licença para testar o preço da assinatura muda o que afeta outros assinantes ativos com as seguintes etapas:
- Clique em Gerenciar no card Configurações de assinatura do Painel.
- Escolha a assinatura ativa que você quer testar.
- Insira o novo preço.
- Marque ou desmarque a caixa de seleção Desativação do usuário de acordo com os requisitos do teste.
- Clique em Aplicar.
![testar a mudança do preço da assinatura](https://developer.android.com/static/images/google/play/billing/play-billing-lab-price-change.png?authuser=6&hl=pt)
Depois que as alterações forem aplicadas, o preço será atualizado a partir da próxima renovação apenas para o testador. Os outros assinantes ativos não serão afetados. Todas as regras dos testadores de licença serão aplicadas à assinatura de teste. O testador pode e testar o app em processos downstream acionados pela mudança de preço, como notificações de mudança de preço.
Ao planejar períodos de teste, considere o seguinte:
- Devido a uma pequena duração de renovação para os testadores de licença, é possível que um a migração de preço feita no console não será registrada para testadores de licença. Para garantir que notificações e e-mails de mudança de preço possam ser testados, desenvolvedores precisa adiar o faturamento em pelo menos uma hora após o acionamento da alteração de preço.
- As reduções de preço não têm um período de notificação. Os usuários são notificados sobre uma redução no preço logo após a migração da coorte. Isso não muda durante os testes.
- Para aumentos de preço, os tempos de notificação de teste são calculados da mesma forma que os
aumentos reais:
- O usuário é cobrado pela primeira vez no primeiro aniversário de faturamento após um período de notificação obrigatório.
- Os tempos de notificação são calculados de forma retroativa a partir da primeira data de cobrança.
- A notificação final ocorre sempre um minuto antes da cobrança, independente do período de faturamento.
A tabela abaixo mostra períodos de faturamento e notificação de teste para vários períodos de faturamento reais:
Período real de faturamento do plano básico | Período de faturamento de teste | Período de notificação de teste (regiões de ativação e desativação com aviso prévio de 30 dias) | Período de notificação de teste (regiões de desativação com aviso prévio de 60 dias) |
1 semana | 5 minutos | 5 minutos | 10 minutos |
1 mês | 5 minutos | 5 minutos | 10 minutos |
3 meses | 10 minutos | 3 minutos | 6 minutos |
6 meses | 15 minutos | 2 minutos | 4 minutos |
1 ano | 30 minutos | 3 minutos | 6 minutos |
Casos de teste
Abra a próxima seção clicando em Mostrar/ocultar para conferir situações de teste que você precisa usar para verificar a integração da assinatura.
Testar transações pendentes
Teste se as transações pendentes foram tratadas corretamente e se os direitos foram
serão atualizados quando o estado de compra se tornar PURCHASED
. Testadores de licença
ter acesso a dois instrumentos de teste para formas de pagamento atrasadas em que o
o pagamento é concluído ou cancelado automaticamente após alguns minutos.
Faça uma compra com uma forma de pagamento atrasada "Cartão de teste lento recusado após alguns minutos", conforme mostrado na Figura 2. Reinicie o app e confirme se a compra não foi concedida.
Figura 2. Faça uma compra com um cartão de teste lento recusado. Faça uma compra com uma forma de pagamento atrasada "Cartão de teste lento aprovado após alguns minutos", conforme mostrado na Figura 3. Aguarde alguns minutos e confirme se a compra foi concedida.
Figura 3. Faça uma compra com um cartão de teste lento aprovado.
Testar códigos promocionais
Você pode usar o Google Play Console para criar códigos para seus próprios testes. Lembre-se de que você só pode criar 500 códigos promocionais por trimestre em todos os produtos gerenciados de um app.
Teste as seguintes situações de resgate de código promocional:
- Quando o código promocional é inserido na caixa de diálogo de compras iniciada no seu app.
- Quando o código promocional é resgatado no app Google Play Store.
- Quando o código promocional é resgatado em https://play.google.com/store usando o botão Resgatar à esquerda.
Nesses cenários, é importante você testar o resgate de códigos do máximo de maneiras possível. Recomendamos no mínimo a realização dos seguintes testes:
- Resgate antes da instalação do app.
- Resgate enquanto o app está em execução em primeiro plano. Nesse teste, você precisa de outro dispositivo para testar usando o app Google Play Store. Teste resgates em diferentes telas no seu app.
- Resgate com o modo de várias janelas, em que seu app e a Google Play Store são exibidos ao mesmo tempo.
Para cada teste, verifique se o item foi detectado corretamente e se o usuário foi notificado.
Testar a experiência de compra em diferentes regiões
É possível testar a experiência de compra com ou sem o Play Billing Lab:
Testar com
Com o app Play Faturamento Lab para Android, você pode testar fluxo de compra em qualquer região. No entanto, para usar o Laboratório de faturamento do Google Play, é necessário ser um testador de licenças. Use o etapas a seguir para testar:
- Registrar o usuário de faturamento do app como um testador de licenças
- Faça login no app Play Billing Lab com o mesmo usuário.
- Selecione o país desejado e aplique a alteração no Play Billing Lab.
- Inicie o fluxo de compra no app em teste.
![testar a experiência de compra em diferentes regiões](https://developer.android.com/static/images/google/play/billing/play-billing-lab-country.png?authuser=6&hl=pt)
Testar sem
Você também pode testar o fluxo de compra em qualquer região sem usar no laboratório de faturamento do Google Play. Siga estas etapas:
- Crie uma nova conta do Gmail. A conta pode ser criada em qualquer país.
- Também é possível configurar o usuário como testador de licenças.
- Configure a VPN para o país que você quer testar.
- Inicie o fluxo de compra.
Você pode limpar os dados e o cache da Play Store e repetir as etapas 3 e 4 com qualquer país que gostaria de testar. Depois de mudar para um novo país, você precisará em "Limpar dados" para que a Google Play Store remova os dados relacionados ao país.
Ambos os métodos para testar compras permitem testar a qualificação regional da oferta e a experiência do usuário em qualquer região, independentemente do local onde você está realizando os testes físicos.