Vender assinaturas

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
• Confirmação

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:

Se o usuário estiver mudando os direitos à assinatura, especifique a taxa de cálculo proporcional durante a 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 e IMMEDIATE_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:

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:

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: 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 interface 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 alguns usuários 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.

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 grátis como uma oferta especial, por exemplo, oferecendo uma semana de uso gratuito 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 em período de carência, se ativado. Durante esse período, o usuário ainda 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, 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 pedir que ele o corrija.

Você pode fazer isso por conta própria, como 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 aplicativo.

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:

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.
                }
            }
        })

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.
                }
            }
        });