Method: purchases.subscriptions.cancel

Cancela a compra de assinatura de um usuário. A assinatura continua ativa até o prazo de validade. A versão mais recente está disponível em "purchases.subscriptionsv2.cancel" para melhor suporte à biblioteca de cliente.

Solicitação HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
packageName

string

O nome do pacote do aplicativo da assinatura comprada. Por exemplo, com.some.thing.
subscriptionId

string

Observação: desde 21 de maio de 2025, o subscriptionId não é obrigatório e não é recomendado para assinaturas com complementos. O ID da assinatura comprada (por exemplo, "monthly001").
token

string

O token fornecido ao dispositivo do usuário quando a assinatura foi comprada.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "cancellationType": enum (CancellationType)
}
Campos
cancellationType

enum (CancellationType)

Opcional. O tipo de cancelamento da assinatura comprada. Esse campo só é compatível com a solicitação HTTP. Ela não está disponível nas bibliotecas de cliente. Os usuários da biblioteca de cliente podem usar purchases.subscriptionsv2.cancel.

Corpo da resposta

Se a solicitação for concluída, o corpo da resposta estará vazio.

Exemplo

Confira um exemplo de solicitação:

curl -X POST \
  -H "Accept: application/json" \
  "https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/subscriptions/monthly.premium.plan/tokens/EXAMPLE_TOKEN_STRING_12345:cancel"

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/androidpublisher

CancellationType

O tipo de cancelamento solicitado pelo desenvolvedor.

Tipos enumerados
CANCELLATION_TYPE_UNSPECIFIED Tipo de cancelamento não especificado.
USER_REQUESTED_STOP_RENEWALS Cancelamento solicitado pelo usuário. A assinatura pode ser restaurada. Ela apenas interrompe a próxima renovação da assinatura. No caso de uma assinatura parcelada, os usuários ainda precisam concluir o período de fidelidade. Para mais detalhes sobre renovações e pagamentos, acesse https://developer.android.com/google/play/billing/subscriptions#installments
DEVELOPER_REQUESTED_STOP_PAYMENTS O cancelamento foi solicitado pelo desenvolvedor, e a assinatura não pode ser restaurada. Ele interrompe o próximo pagamento da assinatura. Para uma assinatura parcelada, os usuários não precisam pagar a próxima parcela e podem encerrar o período de fidelidade. Para mais detalhes sobre renovações e pagamentos, consulte https://developer.android.com/google/play/billing/subscriptions#installments. Esse é o comportamento padrão quando nenhum tipo de cancelamento é especificado.