Uma renovação pode falhar: cartão vencido, saldo zerado, forma de pagamento removida. O que o seu app faz em seguida decide se o usuário corrige o problema ou sai irritado. Faz parte de Testar monetização.
As regras das lojas podem mudar, então confirme-as nas páginas atuais e monte sua matriz de testes a partir delas.
- Apple: "If you enabled the billing grace period for your apps, there won't be any interruption to days of paid service or to your revenue, if Apple is able to recover the subscription within the billing grace period (either 6 or 16 days, depending on the subscription duration)." (Se você ativou o período de carência de cobrança para seus apps, não haverá interrupção nos dias de serviço pago nem na sua receita, desde que a Apple consiga recuperar a assinatura dentro desse período (6 ou 16 dias, dependendo da duração da assinatura).)
- Google Play: "This recovery period can consist of a grace period followed by an account hold period. During a grace period, the user should still have access to their subscription entitlement." e "When a subscription enters account hold, you should block access to the subscription entitlement." (Esse período de recuperação pode consistir em um período de carência seguido de um período de suspensão da conta. Durante o período de carência, o usuário ainda deve ter acesso à assinatura. E: quando uma assinatura entra em suspensão da conta, você deve bloquear o acesso à assinatura.) A duração do período de carência pode ser ajustada no Play Console; a suspensão da conta é, por padrão, "60 days minus any grace period duration" (60 dias menos a duração de qualquer período de carência).
Fontes: Central de Ajuda do App Store Connect da Apple (Offer auto-renewable subscriptions); Android Developers (Subscriptions; Subscription lifecycle); todas consultadas em 2026-10-22.
Monte a matriz primeiro
Pela documentação, liste todos os estados de assinatura que a loja pode informar (por exemplo: ativa, em nova tentativa, suspensa, expirada). Para cada estado, escreva: qual acesso o usuário deve ter, o que o app deve dizer e o que o usuário pode fazer. Depois teste cada linha.
Verificações
- Cada estado tem uma regra de acesso definida. Nenhum estado cai em "indefinido, então bloqueado" por acidente.
- O usuário é avisado, no app, que o pagamento falhou. Palavras simples, uma única ação ("Atualizar forma de pagamento"), sem culpar ninguém.
- A ação leva ao lugar certo. O link abre o gerenciamento de pagamento da loja, não um beco sem saída. Como verificar: toque nele em um aparelho real.
- A mensagem some depois da correção. Pague de novo no sandbox; o aviso desaparece sem reinstalar o app.
- Sem insistência. Um banner ou um único diálogo, não uma tela bloqueante a cada abertura enquanto o acesso ainda é válido.
- O acesso não é cortado cedo demais nem mantido por tempo demais. Compare o que o app permite com o estado que você registrou.
- Expiração final. Quando a assinatura termina, o usuário cai em um paywall calmo que explica o que aconteceu. Veja fluxo de período de teste grátis.
- Assinar de novo após a expiração. A compra funciona e o acesso volta. Veja restaurar compras.
- Falha de pagamento durante uma troca de plano. Veja upgrade e downgrade.
- Servidor e app concordam. Se você acompanha o estado em um servidor, verifique se ele trata os mesmos estados e eventos fora de ordem (verificações no servidor).
- Tempo no sandbox. As renovações no sandbox rodam em prazos encurtados; compare com os períodos reais acima antes de tirar conclusões sobre textos como "em 6 dias".
Redação
Não prometa datas que você não consegue ler na loja. "Não conseguimos renovar sua assinatura" é verdadeiro; "você tem 7 dias restantes" só é verdadeiro se você tiver verificado.
Relacionados: interrupção de compra, exibição de preço por região.
Pergunte a um testador qual mensagem ele esperaria e se saberia o que fazer. Comece grátis.