Este tópico descreve como processar eventos de ciclo de vida da assinatura, como renovações e expirações. Ele também descreve outros recursos de assinatura, como oferecer promoções e permitir que os usuários gerenciem as próprias assinaturas.
Se você não configurou produtos por assinatura para seu app, consulte Criar e configurar seus produtos.
Visão geral das assinaturas
Uma assinatura representa um conjunto de benefícios a que os usuários têm acesso durante um determinado período, como um serviço de streaming de música, por exemplo.
É possível ter várias assinaturas no mesmo app para representar conjuntos de benefícios diferentes ou níveis diferentes de um único conjunto de benefícios (por exemplo, nível prata ou ouro).
Usando os planos básicos e as ofertas, é possível criar várias configurações para um mesmo produto por assinatura. Por exemplo, você pode criar uma oferta introdutória para usuários que nunca compraram uma assinatura no seu app ou uma oferta de upgrade para usuários que já têm uma assinatura.
Para saber mais sobre produtos por assinatura, planos básicos e ofertas, consulte a documentação na Central de Ajuda do Play Console.
Integração de planos pré-pagos
Os planos pré-pagos não são renovados automaticamente após o vencimento. Para estender o direito de assinatura sem que haja interrupção, o usuário precisa recarregar o plano pré-pago dessa assinatura.
Para recargas, inicie o fluxo de faturamento da mesma maneira que você faria para uma compra. Não é necessário indicar que a compra é uma recarga.
As recargas de planos pré-pagos sempre usam o modo de cálculo proporcional IMMEDIATE_AND_CHARGE_FULL_PRICE
.
Não é necessário definir esse modo explicitamente.
O usuário é imediatamente cobrado por um período de faturamento completo,
e o direito de uso é estendido pelo prazo especificado na recarga.
Após a recarga, os seguintes campos no objeto de resultado
Purchase
serão atualizados para refletir a compra de recarga mais recente:
- ID do pedido
- Horário da compra
- Assinatura
- Token da compra
- Recebida
Os campos Purchase
a seguir sempre contêm os mesmos dados encontrados na
compra original:
- Nome do pacote
- Estado da compra
- Produtos
- Renovação automática
Confirmação de compra de planos pré-pagos
Assim como nas assinaturas de renovação automática, é necessário apresentar uma confirmação de compra para os planos pré-pagos. Tanto a primeira compra quanto todas as recargas posteriores precisam ser confirmadas. Para ver mais informações, consulte Como processar compras.
Alguns planos pré-pagos podem ter prazos de duração curtos. Por isso, é importante confirmar a compra o mais rápido possível.
Planos pré-pagos com prazo de uma semana ou mais precisam ser confirmados dentro de três dias.
Planos com prazo menor que uma semana precisam ser confirmados até metade do período de assinatura do plano. Por exemplo, para um plano pré-pago de três dias, os desenvolvedores têm até um dia e meio para enviar a confirmação.
Usar links diretos para permitir que os usuários gerenciem uma assinatura
Como desenvolvedor, você precisa facilitar o gerenciamento da assinatura dos seus clientes. Seu app precisa incluir um link em uma tela de configurações ou preferências para que os usuários possam gerenciar as assinaturas deles. Veja um exemplo desse link na Figura 4.

No gerenciador de cliques desse link, adicione uma lógica para determinar se o usuário tem
assinaturas não vencidas do seu app, em que expiryTime
esteja no
futuro ou autoRenewing
esteja definido como true
.
O productId
de cada assinatura corresponde ao ID do produto atribuído à assinatura
no momento de criação no Play Console. Para determinar o
productId
de uma assinatura de forma programática, consulte a lista
de assinaturas associadas a um usuário específico no back-end do app.
Se o usuário tiver uma assinatura não vencida, direcione-o para um URL semelhante ao seguinte, substituindo "your-sub-product-id" e "your-app-package" pelo ID da assinatura e pelas informações do pacote do aplicativo:
https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package
Se um usuário não tiver assinaturas não vencidas no seu app, use o seguinte URL para direcioná-lo à página que mostra todas as outras assinaturas, conforme mostrado nas figuras 5 e 6:
https://play.google.com/store/account/subscriptions


Você pode encontrar um código de exemplo para a lógica do link de assinatura no aplicativo de exemplo Classy Taxi (link em inglês).
Permitir que os usuários façam upgrade e downgrade ou modifiquem a assinatura
Você pode oferecer aos usuários diferentes níveis de assinatura, como um nível básico e um nível premium. A Figura 7 mostra uma tela que oferece dois níveis de assinatura:

É importante que os usuários possam acessar uma tela semelhante à Figura 7 para fazer upgrade ou downgrade de uma assinatura. Ao fazer upgrade ou downgrade de uma assinatura, você pode definir o modo de cálculo proporcional, que determina como a mudança afeta os assinantes.
A tabela a seguir lista os modos de cálculo proporcional disponíveis:
Modo de cálculo proporcional | Descrição |
---|---|
IMMEDIATE_WITH_TIME_PRORATION |
A assinatura recebe upgrade ou downgrade imediatamente. Qualquer tempo restante é ajustado com base na diferença de preço e creditado à nova assinatura, adiando a próxima data de faturamento. Esse é o comportamento padrão. |
IMMEDIATE_AND_CHARGE_PRORATED_PRICE |
A assinatura recebe upgrade imediatamente, e o ciclo de faturamento permanece o mesmo. A diferença de preço referente ao período restante é cobrada do usuário. |
IMMEDIATE_WITHOUT_PRORATION |
A assinatura recebe upgrade ou downgrade imediatamente, e o novo preço é cobrado quando a assinatura é renovada. O ciclo de faturamento permanece o mesmo. |
DEFERRED |
A assinatura só recebe upgrade ou downgrade quando ela é renovada. |
IMMEDIATE_AND_CHARGE_FULL_PRICE |
O upgrade ou downgrade da assinatura é feito e o usuário recebe a cobrança imediata do preço total pela nova titularidade. O valor restante da assinatura anterior é transferido para a mesma titularidade ou um valor proporcional ao tempo é transferido ao mudar para uma titularidade diferente. |
Se o usuário estiver mudando os direitos à assinatura, especifique a taxa de cálculo proporcional no ambiente de execução. Não é possível especificar um modo de cálculo proporcional padrão no Google Play Console para mudanças de direitos à assinatura.
Se o usuário não estiver mudando os direitos à assinatura, você poderá usar
o modo de cálculo proporcional padrão configurado no Play Console. Também é possível
modificar esse comportamento especificando um modo de cálculo proporcional em
SubscriptionUpdateParams
. Atente-se às seguintes restrições:
- Ao fazer upgrade ou downgrade ou mudar uma mesma assinatura
de um plano pré-pago ou com renovação automática para um plano pré-pago,
o único modo de cálculo proporcional permitido é
IMMEDIATE_AND_CHARGE_FULL_PRICE
. Se você especificar qualquer outro modo de cálculo proporcional, a compra vai falhar e um erro será exibido ao usuário. - Ao mudar de plano em uma mesma assinatura de um plano pré-pago
para um plano com renovação automática, os modos de cálculo proporcional válidos são
IMMEDIATE_AND_CHARGE_FULL_PRICE
eIMMEDIATE_WITHOUT_PRORATION
. Se você especificar qualquer outro modo de cálculo proporcional, a compra vai falhar e um erro será exibido ao usuário.
Exemplos de cálculo proporcional
Para entender como cada modo de cálculo proporcional funciona, considere o seguinte cenário:
Paulo tem uma assinatura de conteúdo on-line do app Country Gardener. Atualmente, trata-se da assinatura mensal da versão de Nível 1 do conteúdo, que tem apenas texto. Essa assinatura custa R$ 2/mês e é renovada no primeiro dia do mês.
Em 15 de abril, Paulo optou por fazer upgrade para a versão anual do Nível 2, que inclui vídeos com novidades e custa R$ 36/ano.
Ao fazer upgrade da assinatura, o desenvolvedor seleciona um modo de cálculo proporcional. A lista a seguir descreve como cada modo de cálculo proporcional afeta a assinatura de Paulo.
IMMEDIATE_WITH_TIME_PRORATION
- A assinatura do Nível 1 de Paulo termina imediatamente. Como o pagamento vale por um mês inteiro (de 1º a 30 de abril), mas Paulo usou apenas metade desse período, metade da assinatura de um mês (R$ 1) é aplicada à nova assinatura. No entanto, como a nova assinatura custa R$ 36 por ano, o saldo de crédito de R$ 1 paga por apenas 10 dias (16 a 25 de abril). Então, no dia 26 de abril, serão cobrados R$ 36 por uma nova assinatura e outros R$ 36 em 26 de abril de cada ano seguinte.
IMMEDIATE_AND_CHARGE_PRORATED_PRICE
- Esse modo pode ser usado porque o preço da assinatura do Nível 2 por unidade de tempo (R$ 36/ano = R$ 3/mês) é maior que o preço da assinatura do Nível 1 por unidade de tempo (R$ 2/mês). A assinatura do Nível 1 de Paulo é encerrada imediatamente. Como ele pagou por um mês inteiro, mas usou apenas metade disso, metade da assinatura de um mês (R$ 1) é aplicada à nova assinatura. No entanto, como essa nova assinatura custa R$ 36 por ano, os 15 dias restantes custam R$ 1,50. Assim, ele recebe a cobrança da diferença de R $0,50 pela nova assinatura. Em 1º de maio, são cobrados R$ 36 pelo novo nível da assinatura, e outros R$ 36 no dia 1º de maio de cada ano.
IMMEDIATE_WITHOUT_PRORATION
- A assinatura do Nível 1 de Paulo recebe imediatamente upgrade para o Nível 2, sem nenhum custo extra. Em 1º de maio, são cobrados R$ 36 pelo novo nível de assinatura e outros R$ 36 no dia 1º de maio de cada ano.
DEFERRED
- A assinatura do Nível 1 de Paulo continua até a expiração, em 30 de abril. No dia 1º de maio, a assinatura do Nível 2 entra em vigor, e Paulo recebe uma cobrança de R$36 pelo novo nível de assinatura.
IMMEDIATE_AND_CHARGE_FULL_PRICE
- A assinatura do Nível 1 de Paulo é encerrada imediatamente. A assinatura do Nível 2 começará imediatamente, com uma cobrança de R$36. Como ele pagou por um mês inteiro, mas usou apenas metade disso, metade da assinatura de um mês (R$1) é aplicada à nova assinatura. Como essa nova assinatura custa R$36/ano, ele receberia um período de 1/36 do ano adicionado ao período da assinatura (aproximadamente 10 dias). Portanto, a próxima cobrança de Paulo seria um ano e 10 dias após o dia atual, custando R$ 36. Depois disso, ele receberá uma cobrança de R$36 por ano seguinte.
Ao escolher um modo de cálculo proporcional, leia nossas recomendações de cálculo proporcional.
Seu app pode oferecer um upgrade ou downgrade aos usuários usando as mesmas etapas utilizadas para iniciar um fluxo de compra. No entanto, ao fazer upgrade ou downgrade, você precisa fornecer detalhes sobre a assinatura atual, a assinatura futura (upgrade ou downgrade) e o modo de cálculo proporcional a ser usado, conforme mostrado no exemplo a seguir:
String offerToken = productDetails
.getSubscriptionOfferDetails(selectedOfferIndex)
.getOfferToken();
BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
.setProductDetailsParamsList(
ImmuableList.of(
ProductDetailsParams.newBuilder()
// fetched via queryProductDetailsAsync
.setProductDetails(productDetails)
// offerToken can be found in
// ProductDetails=>SubscriptionOfferDetails
.setOfferToken(offerToken)
.build()))
.setSubscriptionUpdateParams(
SubscriptionUpdateParams.newBuilder()
// purchaseToken can be found in Purchase#getPurchaseToken
.setOldSkuPurchaseToken("old_purchase_token")
.setReplaceSkusProrationMode(ProrationMode.IMMEDIATE_AND_CHARGE_FULL_PRICE)
.build())
.build();
BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);
// process purchase results from PurchasesUpdatedListener registered with BillingClient
public void onPurchaseUpdated(BillingResult billingResult, @Nullable List<Purchase> purchases) {
// check BillingResult
// process returned Purchase list, e.g. grant entitlement
}
Para os modos de cálculo proporcional de substituição imediata, o app recebe a nova
compra no
PurchasesUpdatedListener
.
A compra também está disponível em
BillingClient.queryPurchasesAsync()
.
Ao receber o token de compra, siga o mesmo
processo de verificação
usado para um novo token. Confirme essas
compras com
BillingClient.acknowledgePurchase()
da Biblioteca Google Play Faturamento ou
Purchases.subscriptions:acknowledge
da API Google Play Developer.
A API Google Play Developer retorna um linkedPurchaseToken
no
recurso de assinatura.
Invalide o token fornecido no linkedPurchaseToken
para
garantir que o token antigo não seja usado para acessar seus serviços. Consulte
Upgrades, downgrades e novas assinaturas
para ver informações sobre como processar compras de upgrade e downgrade.
No modo de substituição adiada, seu app recebe uma chamada para a interface
PurchasesUpdatedListener
com a compra do plano de assinatura original e um status do
sucesso do upgrade ou downgrade. Até que a substituição entre em vigor,
BillingClient.queryPurchasesAsync()
continua retornando a compra do plano de assinatura original. Quando o novo
plano entra em vigor, queryPurchasesAsync()
retorna os dados de compra
da nova assinatura, e uma notificação SUBSCRIPTION_RENEWED
é enviada ao
servidor de back-end seguro. Para substituições adiadas, é
altamente recomendável detectar essa notificação e confirmar
a compra usando
Purchases.subscriptions:acknowledge
.
O linkedPurchaseToken
no recurso de assinatura pode ser usado para
determinar qual usuário no back-end da assinatura, se aplicável, será
atualizado com a nova titularidade. Seu app não deve depender de que o usuário
abra o app e confirme via
BillingClient.acknowledgePurchase()
,
já que o usuário pode não abrir o app em até três dias após a mudança do plano
entrar em vigor.
Como fazer upgrade com ofertas de teste sem custo financeiro ou preço inicial
As configurações de qualificação para teste sem custo financeiro se aplicam quando um usuário faz upgrade ou downgrade. É possível ajustar as configurações de qualificação para teste sem custo financeiro no Google Play Console.
Observe o seguinte:
- Se os usuários só tiverem direito a um teste sem custo financeiro para todas as assinaturas disponíveis no seu app, o novo plano que ele está assinando não terá período de teste nem oferta de preço inicial.
- Se você oferecer um teste sem custo financeiro para cada produto por assinatura, o novo plano que o usuário está adotando poderá ter o período de teste ou a oferta preço inicial.
A tabela a seguir descreve o comportamento de cada modo de cálculo proporcional se os planos novos e antigos tiverem um teste sem custo financeiro e o usuário estiver fazendo upgrade durante esse período de teste:
Um teste sem custo financeiro por app | Um teste sem custo financeiro para cada produto por assinatura | |
IMMEDIATE_WITH_TIME_PRORATION | O usuário perde o teste sem custo financeiro imediatamente. O período de teste sem custo financeiro restante é convertido em um período sem custo financeiro equivalente do novo nível com base na diferença de preço. | O usuário perde o teste sem custo financeiro anterior, mas inicia imediatamente um novo teste. Além disso, o período de teste gratuito restante do nível antigo é convertido em um período equivalente do novo nível e adicionado ao novo teste gratuito. |
IMMEDIATE_AND_CHARGE_PRORATED_PRICE |
O usuário perde o teste sem custo financeiro imediatamente. A diferença de preço referente ao período restante é cobrada do usuário. A próxima data de faturamento permanece inalterada. Observação: essa opção está disponível apenas para um upgrade de assinatura, em que o preço por unidade de tempo aumenta. |
|
IMMEDIATE_WITHOUT_PRORATION | O usuário recebe um upgrade imediato para o novo nível. O usuário mantém o acesso ao teste sem custo financeiro para o novo nível até o final do período de faturamento anterior. | |
DEFERRED | O usuário mantém o acesso ao teste sem custos financeiros da assinatura antiga até a próxima data de faturamento. | |
IMMEDIATE_AND_CHARGE_FULL_PRICE | O usuário perde o teste sem custo financeiro imediatamente. O preço da nova assinatura será cobrado do usuário. A próxima data de faturamento passa a ser o novo período de assinatura somado ao tempo restante do teste sem custo financeiro. |
Para entender como as transições de testes gratuitos funcionam no caso padrão de um teste por app, considere este cenário:
Maria tem uma assinatura de conteúdo on-line do app Country Gardener. Atualmente, trata-se da assinatura mensal da versão de Nível 1 do conteúdo, que tem apenas texto. Essa assinatura custa R$ 10/mês, e ela assinou no dia 1º de abril. Ela está aproveitando um teste sem custo financeiro de 30 dias como assinante pela primeira vez, o que significa que o primeiro pagamento vence em 1º de maio.
Em 15 de abril, Maria decide fazer upgrade para a assinatura de Nível 2, que inclui vídeos com novidades e custa R$ 20/mês. Essa segunda assinatura também tem um teste de 30 dias.
A lista a seguir descreve a transição do teste sem custo financeiro para cada modo de cálculo proporcional:
IMMEDIATE_WITH_TIME_PRORATION
: Maria recebe um upgrade imediato para o Nível 2. Como Maria fez upgrade na metade do período de assinatura, metade da assinatura mensal (15 dias, no valor de R$10/mês) é aplicada à nova assinatura. No entanto, como essa nova assinatura custa R$ 20/mês, o saldo de 15 dias paga apenas por 7,5 dias. Maria não está qualificada para outro teste sem custo financeiro do Nível 2. Portanto, a partir de 22 de abril, ela vai receber uma cobrança mensal de R$ 20.IMMEDIATE_AND_CHARGE_PRORATED_PRICE
: este modo pode ser usado porque o preço da assinatura de Nível 2 por unidade de tempo (R$ 20/mês) é maior que o preço da assinatura de Nível 1 por unidade de tempo (R$ 10/mês). A assinatura do Nível 1 de Maria recebe um upgrade imediato para o Nível 2, e ela perde o teste sem custo financeiro. Como a próxima data de faturamento de Maria era 1º de maio, ela recebeu uma cobrança de R$ 10 para cobrir a segunda metade de abril. A partir de 1º de maio, ela receberá uma cobrança de R$ 20 todo mês.IMMEDIATE_WITHOUT_PRORATION
: a assinatura do Nível 1 de Maria recebe um upgrade imediato para o Nível 2. Maria continua com o teste sem custo financeiro até 30 de abril e agora tem acesso ao conteúdo do Nível 2. A partir de 1º de maio, ela recebe uma cobrança de R$ 20 ao mês.DEFERRED
: a assinatura do Nível 1 de Maria continua até o próximo pagamento, em 1º de maio. Em 1º de maio, a assinatura do Nível 2 entra em vigor, e a cobrança de R$ 20 é feita no primeiro dia de cada mês.IMMEDIATE_AND_CHARGE_FULL_PRICE
: a assinatura do Nível 1 de Maria recebe um upgrade imediato para o Nível 2, e ela perde o teste sem custo financeiro. Ela recebe uma cobrança de R$20 imediatamente. Como Maria tem 15 dias restantes no teste sem custo financeiro, a próxima data de faturamento é de 1 mês + 15 dias a partir de agora ou 1º de julho. A partir de 1º de julho, ela receberá uma cobrança de R$20 por mês.
A lista a seguir descreve o comportamento de transição se o desenvolvedor permitir um teste sem custo financeiro por assinatura:
IMMEDIATE_WITH_TIME_PRORATION
: Maria recebe um upgrade imediato para o Nível 2. Como Maria fez upgrade na metade do período de assinatura, metade da assinatura mensal (15 dias, no valor de R$ 10/mês) é aplicada à nova assinatura. No entanto, como essa nova assinatura custa R$ 20/mês, o saldo de 15 dias paga apenas por 7,5 dias. Maria está qualificada para outro teste sem custo financeiro do Nível 2. Portanto, ela não é cobrada por mais 37,5 dias. A partir de 22 de maio, ela recebe uma cobrança de R$ 20 ao mês.IMMEDIATE_AND_CHARGE_PRORATED_PRICE
: este modo pode ser usado porque o preço da assinatura de Nível 2 por unidade de tempo (R$ 20/mês) é maior que o preço da assinatura de Nível 1 por unidade de tempo (R$ 10/mês). A assinatura do Nível 1 de Maria recebe um upgrade imediato para o Nível 2, e ela perde o teste sem custo financeiro. Como a próxima data de faturamento de Maria era 1º de maio, ela recebeu uma cobrança de R$ 10 para cobrir a segunda metade de abril. A partir de 1º de maio, ela receberá uma cobrança de R$ 20 todo mês.IMMEDIATE_WITHOUT_PRORATION
: a assinatura do Nível 1 de Maria recebe um upgrade imediato para o Nível 2. Maria continua com o teste sem custo financeiro até 30 de abril e agora tem acesso ao Nível 2.DEFERRED
: a assinatura do Nível 1 de Maria continua até o próximo pagamento, em 1º de maio. Em 1º de maio, a assinatura do Nível 2 entra em vigor, e a cobrança de R$ 20 é feita no primeiro dia de cada mês.IMMEDIATE_AND_CHARGE_FULL_PRICE
: a assinatura do Nível 1 de Maria recebe um upgrade imediato para o Nível 2, e ela perde o teste sem custo financeiro. Ela recebe uma cobrança de R$20 imediatamente. Como Maria tem 15 dias restantes no teste sem custo financeiro, a próxima data de faturamento é de 1 mês + 15 dias a partir de agora ou 1º de julho. A partir de 1º de julho, ela receberá uma cobrança de R$20 por mês.
Recomendações de cálculo proporcional
A tabela a seguir mostra diferentes cenários de cálculo proporcional e o que recomendamos para cada um deles:
Cenário | Modo de cálculo proporcional recomendado | Resultado |
---|---|---|
Upgrade para um nível mais caro | IMMEDIATE_AND_CHARGE_PRORATED_PRICE |
O usuário recebe acesso imediatamente, mantendo o mesmo período de faturamento. |
Downgrade para um nível mais barato | DEFERRED |
O usuário já pagou pelo nível mais caro, então manterá o acesso até a próxima data de faturamento. |
Mudança de período recorrente no mesmo nível (por exemplo, mensal para anual) | DEFERRED |
O usuário pagará o novo preço recorrente na próxima data de faturamento. |
Upgrade durante o teste sem custo financeiro, mantendo o teste | IMMEDIATE_WITHOUT_PRORATION |
O usuário mantém o acesso ao teste sem custo financeiro, mas faz upgrade para um nível superior pelo restante do teste. |
Upgrade durante o teste sem custo financeiro, encerrando o acesso a ele | IMMEDIATE_AND_CHARGE_PRORATED_PRICE |
O usuário recebe acesso ao novo nível imediatamente, mas não tem mais o teste sem custo financeiro. |
Gestão de clientes
Com as notificações do desenvolvedor em tempo real, é possível detectar imediatamente quando um usuário decide cancelar. Quando um usuário cancela a assinatura antes da expiração, você pode enviar notificações push ou mensagens no app para pedir que ele a renove.
Depois que um usuário cancela a assinatura, você pode usar o app ou a Play Store tentar convencer ele a renovar a assinatura. A tabela a seguir descreve vários cenários de assinatura, com ações associadas de recuperação e requisitos de app.
Antes da expiração da assinatura | Após a expiração da assinatura | |||
No app | Na Play Store | No app | Na Play Store | |
Recurso de recuperação | Assinatura no app | Restauração | Assinatura no app | Nova assinatura |
O usuário percorre o fluxo de finalização da compra | Sim | Não | Sim | Sim |
A assinatura do usuário permanece associada ao mesmo SKU | O usuário pode se inscrever para um SKU igual ou diferente | Sim | O usuário pode se inscrever para um SKU igual ou diferente | Sim |
Cria um novo token de compra | Sim | Não | Sim | Sim |
Ativado por padrão | Não | Sim, a compatibilidade é necessária para todos os desenvolvedores | Não |
Apps sem a Biblioteca Faturamento versão 2.0 ou mais recente: não. Apps com a Biblioteca Faturamento versão 2.0 ou mais recente: sim. Os desenvolvedores podem desativar no console. |
Quando o usuário é cobrado |
Se usar o mesmo SKU: no fim do período de faturamento atual. Se usar um SKU diferente: depende do modo de cálculo proporcional. |
Fim do período de faturamento atual | Imediatamente | Imediatamente |
Implementação necessária | Fornecer uma IU de nova assinatura no seu app |
Detectar mudanças no estado da assinatura Link direto para a Play Store |
Fornecer uma IU de nova assinatura no seu app | Processar compras fora do aplicativo |
Antes da expiração da assinatura: no app
Para assinaturas que foram canceladas, mas ainda não expiraram, é possível permitir que os assinantes restaurem as assinaturas no seu app aplicando o mesmo fluxo de compra de produto no aplicativo usado para novos assinantes. Verifique se a IU reflete que o usuário tem uma assinatura existente. Por exemplo, é possível exibir a data de validade atual do usuário e o preço recorrente com um botão Reativar.
Na maioria das vezes, convém oferecer ao usuário o mesmo preço e o mesmo SKU que ele já assinava, conforme mostrado a seguir:
- Inicie uma nova compra de assinatura com o mesmo SKU.
- A nova assinatura substitui a antiga e será renovada na mesma data de validade. A assinatura antiga será marcada imediatamente como expirada.
- Por exemplo, Ana tem uma assinatura do app Example Music, e a assinatura expira no dia 1º de agosto. Em 10 de julho, ela refaz a assinatura de um mês pelo mesmo preço mensal. A nova assinatura é proporcional ao crédito restante, fica ativa imediatamente e ainda é renovada em 1º de agosto.
Se quiser oferecer um preço diferente (por exemplo, um novo teste sem custo financeiro ou um desconto de recuperação), forneça um SKU diferente ao usuário:
- Inicie um upgrade ou downgrade com um SKU diferente usando
o modo de cálculo proporcional
IMMEDIATE_WITHOUT_PRORATION
. - A nova assinatura substitui a antiga e será renovada na mesma data de
validade. O preço do novo SKU é cobrado do usuário, incluindo
preços iniciais, na data de validade original. Se a assinatura antiga
foi criada usando um ID ofuscado da conta, esse mesmo ID precisa ser transmitido
para o
BillingFlowParams
para serem feitos upgrades e downgrades. - Por exemplo, Ana tem uma assinatura do app Example Music, e a assinatura expira no dia 1º de agosto. Em 10 de julho, ela refaz a assinatura anual com um preço inicial. A nova assinatura será ativada imediatamente, e o preço inicial do usuário será cobrado em 1º de agosto.
- Se você decidir incluir um teste sem custo financeiro ou preço inicial no SKU de recuperação, torne o usuário qualificado para isso desmarcando a caixa Permitir um teste sem custo financeiro por app no Google Play Console, que restringe o usuário a apenas um teste sem custo financeiro por app.
Quando você receber o token,
processe a compra como faria
com uma nova assinatura. Além disso, a API Google Play Developer
retorna um linkedPurchaseToken
no recurso de assinatura. Invalide o token
fornecido no linkedPurchaseToken
para
garantir que o token antigo não seja usado
para acessar seus serviços.
Antes da expiração da assinatura na Play Store
Enquanto a assinatura está cancelada, mas ainda ativa, ela pode ser restaurada pelo usuário na central de assinaturas do Google Play, clicando na opção Renovar assinatura, antes chamada de Restaurar. Isso mantém o mesmo token de compra e assinatura.

Para mais informações sobre como restaurar assinaturas, consulte Restaurações.
Após a expiração da assinatura: no app
É possível permitir que usuários com assinaturas expiradas refaçam a assinatura no app aplicando o mesmo fluxo de compra de produto no aplicativo usado para novos assinantes. Observe o seguinte:
- Para dar um desconto aos usuários, ofereça um ID do produto com preços especiais para sua assinatura, também chamado de SKU de recuperação. Você pode disponibilizar a oferta no seu app ou notificar o usuário sobre a oferta fora do app, como por e-mail.
- Para iniciar uma assinatura de recuperação, abra o fluxo de compra no seu app Android usando a Biblioteca Google Play Faturamento. Esse processo é igual ao de uma nova assinatura, mas você pode determinar o SKU disponível para o usuário.
- Se você decidir incluir um teste sem custo financeiro ou preço inicial no SKU de recuperação, torne o usuário qualificado para isso desmarcando a caixa Permitir um teste sem custo financeiro por app no Google Play Console, que restringe o usuário a apenas um teste sem custo financeiro por app.
- Se o usuário fizer uma nova assinatura do mesmo SKU, ele não estará mais qualificado para testes sem custo financeiros nem preço inicial. Garanta que a IU reflita isso.
Quando você receber o token,
processe a compra como faria
com uma nova assinatura. Você não receberá um linkedPurchaseToken
no recurso de assinatura.
Após a expiração da assinatura: na Play Store
Se ativado, os usuários podem assinar novamente o mesmo SKU por até um ano após a validade. Basta clicar em Renovar assinatura na central de assinaturas do Google Play. Isso gera um novo token de compra e assinatura.

A nova assinatura é considerada uma compra fora do app. Por isso, siga as práticas recomendadas para processar compras feitas fora do app.
Promover sua assinatura
Crie códigos promocionais para oferecer a usuários selecionados um teste gratuito mais longo para uma assinatura já existente. Para saber mais, consulte Códigos promocionais.
O Google Play verifica se o usuário tem uma forma de pagamento válida antes de iniciar o teste sem custo financeiro. Alguns usuários podem ver essa verificação como uma retenção ou cobrança na forma de pagamento deles. A retenção ou cobrança é temporária e será revertida ou reembolsada posteriormente.
Após o término do período de teste, a forma de pagamento do usuário recebe uma cobrança referente ao valor total da assinatura.
Se um usuário cancela uma assinatura a qualquer momento durante o período de teste sem custo financeiro, ela permanece ativa até o final desse período e não é cobrada quando ele terminar.
Cancelar, reembolsar ou revogar
Você pode usar a API Google Play Developer para cancelar, reembolsar ou revogar uma assinatura. Essa funcionalidade também está disponível no Google Play Console.
- Cancelar: os usuários podem cancelar uma assinatura no Google Play. Você também pode fornecer uma opção para os usuários cancelarem no seu app ou site. Seu app deve processar esses cancelamentos conforme descrito em Revogações.
- Reembolsar: quando você faz um reembolso, o usuário pode continuar usando a assinatura. Os reembolsos poderão ser usados se, por exemplo, tiver ocorrido um erro técnico que impediu o usuário de acessar seu produto, mas o erro tiver sido resolvido. Para reembolsar mais do que o pagamento mais recente ou emitir um reembolso parcial, use o Google Play Console.
- Revogar: quando você revoga a assinatura, o usuário perde imediatamente o acesso a ela. Isso poderá ser usado se, por exemplo, tiver ocorrido um erro técnico que impediu o usuário de acessar seu produto e ele não quiser continuar a usá-lo. Seu app deve processar esses cancelamentos conforme descrito em Revogações.
A tabela a seguir ilustra as diferenças entre cancelamento, reembolso e revogação.
Interrompe a renovação | Reembolsa dinheiro | Revoga o acesso | |
Cancelar | Sim | Não | Não |
Reembolsar | Não | Sim | Não |
Revogar | Sim | Sim | Sim |
Adiar o faturamento de um assinante
Você pode adiar a próxima data de faturamento de um assinante de um plano com renovação automática usando
Purchases.subscriptions:defer
da API Google Play Developer. Durante o período de adiamento, o usuário será
assinante do conteúdo com acesso total, mas não será cobrado. A
data de renovação da assinatura é atualizada para a nova data.
Para planos pré-pagos, é possível usar a API de adiamento de faturamento para adiar o prazo de vencimento.
O faturamento adiado permite:
- dar aos usuários acesso gratuito como uma oferta especial, por exemplo, oferecendo uma semana de uso grátis para quem comprar um filme;
- Dar acesso sem custo financeiro aos clientes para desenvolver um bom relacionamento.
O faturamento pode ser adiado de um dia a um ano por chamada de API. Para adiar ainda mais o faturamento, chame a API novamente antes da nova data de faturamento.
Por exemplo, Daniela tem uma assinatura mensal de conteúdo on-line do aplicativo Fishing Quarterly. Normalmente, ela recebe uma cobrança de R$ 1,25 no primeiro dia de cada mês. Em março, ela participou de uma pesquisa on-line para o editor do app. O editor a recompensou com seis semanas sem custo financeiro, adiando o próximo pagamento até 15 de maio, o que corresponde a seis semanas após a data de faturamento anteriormente agendada para 1º de abril. Daniela não é cobrada em abril nem no início de maio e ainda tem acesso ao conteúdo. Em 15 de maio, ela é cobrada pela taxa de assinatura normal de R$ 1,25 para o mês. Agora, a próxima data de renovação é 15 de junho.
Com o adiamento, você pode notificar o usuário por e-mail ou no aplicativo que a data de faturamento foi modificada.
Processar pagamentos recusados
Se houver problemas de pagamento no final de um ciclo de faturamento, o Google vai tentar renovar periodicamente a assinatura por algum tempo antes do cancelamento. Esse período de repetição pode durar até 30 dias mais qualquer período de carência especificado. Durante esse período, o Google também envia e-mails e notificações ao usuário pedindo que ele atualize a forma de pagamento.
Após a recusa do pagamento, a assinatura entra no período de carência, se ativado. Durante esse período, o usuário ainda vai ter acesso à assinatura.
Após qualquer período de carência, a assinatura entra na suspensão de conta por até 30 dias. Durante a suspensão de conta, você pode bloquear o acesso à assinatura.
Para maximizar a probabilidade de recuperação da assinatura durante uma recusa de pagamento, você pode informar o usuário sobre um problema de pagamento e solicitar que ele o corrija.
Você pode fazer isso por conta própria, conforme descrito nas seções período de carência e suspensão de conta, ou implementar a API de mensagens no app, em que o Google mostra uma mensagem aos usuários no seu app.
Mensagens no app
Se você tiver ativado as mensagens no app com o
InAppMessageCategoryId.TRANSACTIONAL
,
o Google Play vai mostrar as mensagens durante o período de carência e a suspensão de conta uma vez
por dia, além de fornecer a eles uma oportunidade de corrigir o pagamento sem sair do app.

Recomendamos que você chame essa API sempre que o usuário abrir o app para determinar se a mensagem vai ser exibida.
Se o usuário recuperar a assinatura, você vai receber um código de resposta de
SUBSCRIPTION_STATUS_UPDATED
com um token de compra. Use esse token de compra para chamar a
API Google Play Developer e atualizar o status da assinatura no app.
Integrar mensagens no app
Para mostrar mensagens no app ao usuário, use
BillingClient.showInAppMessages()
.
Veja um exemplo de como acionar o fluxo de mensagens no app:
Kotlin
val inAppMessageParams = InAppMessageParams.newBuilder() .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL) .build() billingClient.showInAppMessages(activity, inAppMessageParams, object : InAppMessageResponseListener() { override fun onInAppMessageResponse(inAppMessageResult: InAppMessageResult) { if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) { // The flow has finished and there is no action needed from developers. } else if (inAppMessageResult.responseCode == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) { // The subscription status changed. For example, a subscription // has been recovered from a suspend state. Developers should // expect the purchase token to be returned with this response // code and use the purchase token with the Google Play // Developer API. } } })
Java
InAppMessageParams inAppMessageParams = InAppMessageParams.newBuilder() .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL) .build(); billingClient.showInAppMessages(activity, inAppMessageParams, new InAppMessageResponseListener() { @Override public void onInAppMessageResponse(InAppMessageResult inAppMessageResult) { if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) { // The flow has finished and there is no action needed from developers. } else if (inAppMessageResult.responseCode == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) { // The subscription status changed. For example, a subscription // has been recovered from a suspend state. Developers should // expect the purchase token to be returned with this response // code and use the purchase token with the Google Play // Developer API. } } });