Talvez seja necessário realizar ações de gerenciamento em assinaturas ou compras únicas como parte das atividades diárias. Por exemplo, seu atendimento ao cliente pode precisar emitir reembolsos totais ou parciais para os usuários, ou você pode precisar revogar direitos em determinados casos. É possível gerenciar pedidos no Play Console ou, se quiser fazer isso no seu próprio sistema, use a API Google Play Developer.
Cancelar assinaturas
Os cancelamentos de assinaturas podem ser iniciados por usuários ou desenvolvedores.
Cancelamentos iniciados pelo usuário
Os usuários podem cancelar uma assinatura do Google Play a qualquer momento usando a Google Play Store. Se aplicável, você também precisa oferecer uma opção para os usuários cancelarem as assinaturas no app e no site.
A maneira mais fácil de permitir que os usuários cancelem voluntariamente é fornecendo links diretos no app para a Google Play Store, onde eles podem ver e gerenciar as assinaturas.
Cancelamentos iniciados pelo desenvolvedor
Como desenvolvedor, talvez você também precise acionar cancelamentos no back-end.
A API purchases.subscriptions.cancel
permite cancelar uma compra de assinatura.
Por exemplo, é possível usar esse método para desativar um serviço legado.
O cancelamento de uma assinatura não gera reembolso, e o usuário mantém o acesso
até o fim do período de faturamento atual.
Esse método permite especificar os seguintes tipos de cancelamento no parâmetro de corpo da solicitação cancellationType:
USER_REQUESTED_STOP_RENEWALS: Cancela a assinatura como se os usuários tivessem cancelado na Google Play Store. Os pagamentos parcelados vão continuar pelo restante do período de fidelidade atual. Na Google Play Store, os usuários podem restaurar a assinatura antes que ela expire ou renová-la após o vencimento, se essa opção estiver ativada para o plano básico.
DEVELOPER_REQUESTED_STOP_PAYMENTS: cancela a assinatura e impede pagamentos futuros. Os usuários não podem restaurar ou assinar novamente a assinatura na Google Play Store, mas você pode permitir que eles assinem novamente no seu app.
Permitir que os usuários restaurem assinaturas não expiradas
Em alguns cenários, pode ser útil permitir que os usuários restaurem assinaturas não expiradas na central de assinaturas do Google Play depois que você acionar o cancelamento como desenvolvedor. Por exemplo, talvez você queira oferecer um fluxo de cancelamento personalizado no app. Com base na sua lógica de negócios, você pode decidir quais cancelamentos acionados pelo back-end podem ser restaurados pelos usuários.
Para indicar que um usuário pode restaurar o cancelamento, envie uma solicitação POST
para a API purchases.subscriptions.cancel e defina o parâmetro de solicitação
cancellationType como o valor USER_REQUESTED_STOP_RENEWALS.
Exemplo:
- Token de compra da assinatura
1a2b3c4d5e6f7g8h9i0j - Nome do pacote do app
com.your.app - ID da assinatura
your-subscription-product
Solicitação HTTP POST:
https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptions/your-subscription-product/tokens/1a2b3c4d5e6f7g8h9i0j:cancel
Corpo da solicitação:
{
"cancellationType": "USER_REQUESTED_STOP_RENEWALS"
}
Permitir que os usuários renovem assinaturas expiradas
Para permitir a renovação de uma assinatura expirada, ative
a opção Renovar assinatura
no plano básico da assinatura e cancele-a definindo o
parâmetro cancellationType como o valor USER_REQUESTED_STOP_RENEWALS.
Permitir que os usuários renovem a assinatura apenas no seu aplicativo
Se você tiver definido o parâmetro cancellationType como
DEVELOPER_REQUESTED_STOP_PAYMENTS ou não tiver definido o parâmetro
cancellationType, os usuários não poderão
restaurar a assinatura na central de assinaturas do Google Play. No entanto, os usuários podem
assinar novamente pelo app, se necessário.
Essa ação aciona uma Notificação do desenvolvedor em tempo real SUBSCRIPTION_CANCELED. Processe esses cancelamentos conforme descrito em
Cancelamentos.
Adiar o faturamento
É possível estender o período de direito de acesso de uma assinatura
usando o método subscriptionsv2.defer. Quando você adia uma assinatura com complementos, todos os itens dela são adiados pelo mesmo período. Durante o período de adiamento, o usuário continua inscrito no seu conteúdo, mas não é cobrado pelo tempo extra. Quando você adia o faturamento de uma assinatura, as informações de status são atualizadas de acordo e aparecem no campo expiryTime nas
informações de status da compra:
- Para assinaturas recorrentes ativas, o faturamento diferido estende a próxima data de renovação.
- Para planos pré-pagos, o faturamento adiado estende o prazo de validade.
Veja alguns exemplos de como usar o faturamento diferido:
- Oferecer aos usuários acesso sem custo financeiro como uma oferta especial, por exemplo, uma semana de uso sem custo financeiro para assinantes que preencherem uma pesquisa de feedback.
- Ofereça aos clientes acesso sem custo financeiro como uma ação de atendimento ao cliente, por exemplo, após uma interrupção do serviço prolongada que possa ter afetado a capacidade de usar seu serviço.
O faturamento pode ser adiado de um dia a um ano por chamada de API. Para adiar ainda mais o fim do direito de acesso, chame a API novamente antes da nova data de validade.
Essa ação aciona uma Notificação do desenvolvedor em tempo real SUBSCRIPTION_DEFERRED. Consulte Adiar o faturamento de um assinante em Sobre assinaturas para saber como lidar com esses eventos.
Exemplo:
O serviço de streaming FitnessGoals quer fazer uma promoção para incentivar a prática regular de exercícios em fevereiro.
Ela decide oferecer um mês adicional de serviço para qualquer assinante que se exercite com o FitnessGoals pelo menos 10 vezes durante o mês de fevereiro.
Eles acompanham os resultados do desafio e, em 1º de março, chamam o método subscriptionsv2.defer para cada compra de assinatura ativa de usuários que cumpriram o desafio em fevereiro.
Esses usuários recebem um mês extra de vídeos de exercícios regulares sem custo financeiro e contam para todos os amigos como o FitnessGoals os ajuda a manter a saúde.
Emitir reembolsos e revogações
Há muitas situações em que você pode querer emitir um reembolso ou revogar o acesso a uma assinatura ou compra única.
Reembolsar totalmente um pedido pelo código do pedido
Com a API orders.refund,
é possível emitir reembolsos totais para qualquer pedido em até três anos após a compra.
O método orders.refund recebe um parâmetro de revogação que indica se o acesso precisa ser revogado, além de fornecer o reembolso.
Se você emitir uma revogação com a chamada de reembolso para uma compra de assinatura, ela será encerrada imediatamente, acionando uma Notificação do desenvolvedor em tempo real SUBSCRIPTION_REVOKED e uma VoidedPurchaseNotification (registrada na API Voided Purchases). Leia
a seção Revogações do guia de gerenciamento do ciclo de vida de assinaturas para saber
como lidar com esses eventos.
Exemplo:
Para comemorar o início da nova Copa do Mundo, o app de e-sports Football-Not-Soccer decide sortear camisetas virtuais sem custo financeiro para todos os usuários que comprarem novos kits de times nas primeiras 24 horas.
A Football-Not-Soccer usa a API
orders.refundsem transmitir um parâmetro de revogação para reembolsar as compras de camisetas aos vencedores.
Revogar e reembolsar uma assinatura por token de compra
Em alguns casos de uso, talvez seja necessário revogar o acesso à assinatura de um usuário
e oferecer um reembolso. O Google Play Faturamento oferece métodos de revogação, incluindo reembolsos totais
e proporcionais, usando a API
subscriptionsv2.revoke. Com esse endpoint, é possível especificar revocationContext
para determinar como o reembolso é calculado.
Essa ação aciona uma Notificação do desenvolvedor em tempo real de SUBSCRIPTION_REVOKED e uma de VoidedPurchaseNotification, que são registradas na API Voided Purchases. Seu app deve processar esses cancelamentos conforme descrito em
Revogações.
Exemplo:
- Compra com o token
1a2b3c4d5e6f7g8h9i0j - Aplicativo com o nome de pacote
com.your.app - Intenção de emitir um reembolso proporcional
Solicitação HTTP POST:
https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptionsv2/tokens/1a2b3c4d5e6f7g8h9i0j:revoke
Corpo da solicitação:
{
"revocationContext": {
"proratedRefund": {}
}
}
Reembolsos integrais
Se você precisar encerrar uma assinatura e reembolsar o valor total do
período de faturamento atual, emita um reembolso total. Use a função
purchases.subscriptionsv2.revoke
e defina "fullRefund": {} como o tipo de reembolso.
Exemplo:
Maria tem uma assinatura de 30 dias com renovação automática do plano mensal de streaming do SuperMovies. Maria teve alguns problemas técnicos que a impedem de acessar o conteúdo. Ela entra em contato com o atendimento ao cliente no terceiro dia do ciclo de faturamento informando que nunca teve acesso à assinatura.
O atendimento ao cliente localiza os detalhes da compra da assinatura de Maria no sistema e aciona uma chamada para
purchases.subscriptionsv2.revokesolicitando um reembolso total.O atendimento ao cliente informa que ela vai receber um reembolso de 100% do valor da assinatura e que não está mais inscrita no plano.
Reembolsos proporcionais
Se você precisar encerrar uma assinatura e reembolsar parcialmente o tempo restante
do direito, emita um reembolso proporcional. Use a função
purchases.subscriptionsv2.revoke
e defina "proratedRefund": {} como o tipo de reembolso.
Os reembolsos proporcionais são aceitos para assinaturas com renovação automática e planos pré-pagos com duração de pelo menos uma semana.
Exemplo:
Maria tem uma assinatura de 30 dias com renovação automática do plano mensal de streaming do SuperMovies. Ela usa o serviço há algum tempo e está satisfeita. Maria entra em contato com o atendimento ao cliente no dia 15 do ciclo de faturamento dela, informando que vai se mudar para o exterior e não poderá mais usar o serviço a partir do dia seguinte.
O atendimento ao cliente localiza os detalhes da compra da assinatura de Maria no sistema e aciona uma chamada para
purchases.subscriptionsv2.revokesolicitando um reembolso proporcional.O atendimento ao cliente informa que ela vai receber um reembolso de cerca de 50% do preço da assinatura e que o acesso ao serviço será encerrado imediatamente.