# Cancelar assinaturas Saiba como cancelar assinaturas existentes. Os clientes também podem gerenciar assinaturas, faturas e dados de cobrança na [página de cancelamento do portal de clientes](https://docs.stripe.com/customer-management/cancellation-page.md) hospedado pela Stripe. Este guia descreve como usar a [API Subscription](https://docs.stripe.com/api.md#cancel_subscription) ou o [Dashboard](https://dashboard.stripe.com/test/subscriptions) para gerenciar assinaturas de clientes. Se quiser manter uma assinatura ativa, mas interromper temporariamente o recebimento de pagamentos, você pode [suspender a cobrança de pagamentos](https://docs.stripe.com/billing/subscriptions/pause-payment.md). Suspender a coleta de pagamentos não afeta o [status da assinatura](https://docs.stripe.com/billing/subscriptions/overview.md#subscription-statuses), que recomendamos usar como o acionador para iniciar ou interromper o serviço ao seu cliente. As *assinaturas* são canceladas automaticamente após até oito tentativas malsucedidas de faturar o cliente. Você pode configurar o número de tentativas nas [configurações de assinatura](https://dashboard.stripe.com/settings/billing/automatic) do Dashboard. Saiba mais sobre as configurações de recuperação de receitas, como o [Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md#smart-retries) e [e-mails configuráveis de clientes](https://docs.stripe.com/billing/revenue-recovery/customer-emails.md#configure-emails). ## Cancelar assinaturas Você pode cancelar as assinaturas dos clientes manualmente com a [API](https://docs.stripe.com/api/subscriptions/cancel.md) ou no [Dashboard](https://dashboard.stripe.com/test/subscriptions). Por padrão, o cancelamento entra em vigor imediatamente e as *faturas* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) não são mais geradas para assinaturas canceladas. Após o cancelamento, você não poderá mais atualizar a assinatura ou seus [metadados](https://docs.stripe.com/metadata.md). > Se você definir uma data de cancelamento personalizada, não será possível fornecer um reembolso. Um rateio de crédito sempre é gerado. Para evitar a geração de um rateio, certifique-se de que a data de cancelamento personalizada esteja dentro do período de faturamento atual e `proration_behavior` esteja definida como `none`. #### Dashboard Para cancelar uma assinatura no Dashboard: 1. Na página [Assinaturas](https://dashboard.stripe.com/test/subscriptions), clique no menu do final da linha (⋯) e selecione **Cancelar assinatura**. 1. Escolha quando a assinatura será encerrada: imediatamente, ao final do período ou em um dia específico. 1. Opte por fornecer um reembolso de um valor [proporcional](https://docs.stripe.com/billing/subscriptions/prorations.md), reembolsar o último pagamento integral ou não fornecer [reembolso](https://docs.stripe.com/refunds.md). 1. Após finalizar todas as configurações, clique em **Cancelar assinatura**. #### API Para cancelar uma assinatura usando a API: ```curl curl -X DELETE https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" ``` ### Ratear para faturamento por uso Quando uma assinatura já consumiu parte de um período de faturamento pago, você pode ratear o cancelamento passando o parâmetro [prorate](https://docs.stripe.com/api/subscriptions/cancel.md#cancel_subscription-prorate). Quanto um cancelamento é rateado, você tem a opção de emitir uma fatura para: - Rateamentos pendentes - [Uso medido](https://docs.stripe.com/products-prices/pricing-models.md#usage-based-pricing) Se você não ratear a assinatura, todo o uso medido será descartado e o cliente não receberá crédito por possíveis rateios. Crie uma fatura final imediatamente usando o parâmetro [invoice_now](https://docs.stripe.com/api/subscriptions/cancel.md#cancel_subscription-invoice_now). Se você deve um crédito ao cliente após o cancelamento, é possível adicionar o crédito ao saldo de crédito do cliente para aplicar a faturas futuras. Para [reembolsar um cliente](https://support.stripe.com/questions/refunding-credit-balance-to-customer-after-subscription-downgrade-or-cancellation), emita [reembolsos](https://docs.stripe.com/refunds.md#issuing) e [ajuste o saldo da conta](https://docs.stripe.com/billing/customer/balance.md#modifying) para zero. ### Cancelar ao final do período de cobrança atual Para cancelar uma assinatura no final do período de faturamento atual, defina `cancel_at_period_end` como `true`: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d cancel_at_period_end=true ``` Isso permite que a assinatura conclua o período já pago pelo cliente. Você pode reativar assinaturas agendadas para cancelamento, atualizando `cancel_at_period_end` para `false`. Você pode reativar a assinatura a qualquer momento até o final do período. ### Cancelar após alterações agendadas ou em períodos de cobrança futuros Para agendar o término de uma assinatura após um número específico de períodos de cobrança, [crie um cronograma de assinatura](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md). Defina a duração do agendamento especificando uma ou mais fases e intervalos e defina o atributo [end_behavior](https://docs.stripe.com/api/subscription_schedules/create.md#create_subscription_schedule-end_behavior) como `cancel`. Com um comportamento final de `cancel`, os cronogramas de assinatura gerenciam automaticamente o atributo [cancel_at](https://docs.stripe.com/billing/subscriptions/cancel.md#custom-cancel-date) da assinatura. Quando o cronograma está em sua última fase, a data de cancelamento da assinatura é definida como a data de término da fase. Caso contrário, a data de cancelamento não é definida na assinatura. Por isso, adicionar uma nova fase a um cronograma que está em sua última fase remove a data de cancelamento. Se a assinatura estiver no último período de faturamento quando a data de cancelamento for prorrogada ou removida, as âncoras de término do período e de ciclo de faturamento podem ser alteradas. Veja como [definir uma data de cancelamento personalizada](https://docs.stripe.com/billing/subscriptions/cancel.md#custom-cancel-date) para obter mais detalhes. ### Configurar cancelamento automático após uma contestação > #### Suporte limitado > > Este recurso só está disponível para pagamentos contestados por cartão de crédito e débito no *valor total*. O retardo de qualquer cancelamento automático não é compatível com [clocks de teste](https://docs.stripe.com/billing/testing/test-clocks/simulate-subscriptions.md). Quando um cliente [contesta](https://docs.stripe.com/disputes.md) uma cobrança de uma assinatura, a assinatura continua o ciclo, o que pode criar mais cobranças contestadas. Você pode alterar esse comportamento no [Dashboard](https://dashboard.stripe.com/settings/billing/automatic) para cancelar assinaturas. As alterações na assinatura entram em vigor após aproximadamente uma hora. Em [Gerenciar pagamentos contestados](https://dashboard.stripe.com/settings/billing/automatic), selecione uma das seguintes opções: - **cancelar a assinatura imediatamente sem qualquer cobrança proporcional** — A assinatura é cancelada imediatamente sem qualquer cobrança proporcional. Não é possível reiniciar uma assinatura cancelada. Você precisa criar uma assinatura para o cliente se quiser continuar a cobrá-lo. - **cancelar a assinatura ao final do período** – A assinatura é cancelada ao final do período de faturamento atual e [cancel_at_period_end](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-cancel_at_period_end) é definido como `true`. Isso permite que você trabalhe no processo de contestação antes do cancelamento. Assinaturas gerenciadas com [cronogramas](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md) são removidas do cronograma e então canceladas. Isso significa que as demais alterações agendadas não serão aplicadas. ## Processar itens de fatura ao cancelar assinaturas Seu cliente ainda pode ser cobrado por [itens de fatura](https://docs.stripe.com/billing/invoices/subscription.md#adding-draft-invoice-items) pendentes em uma assinatura nos seguintes casos: - O cancelamento da assinatura inclui uma fatura final - Seu cliente tem outra assinatura ativa Para evitar cobrar o cliente por itens de fatura pendentes, [exclua manualmente](https://docs.stripe.com/api.md#delete_invoiceitem) os itens da fatura. Da mesma forma, qualquer[uso](https://docs.stripe.com/billing/subscriptions/usage-based/recording-usage.md) relatado durante o período de faturamento é faturado no final do período. Para evitar uma cobrança final pelo uso, use o parâmetro [clear_usage](https://docs.stripe.com/api.md#update_subscription-items-clear_usage) para [atualizar a assinatura](https://docs.stripe.com/api.md#update_subscription) e remover o preço por consumo. Se o cancelamento da assinatura for definido para o final do período, todas as cobranças proporcionais pendentes continuarão ativas e serão cobradas no final do período. Se a assinatura for cancelada antes do final do período, os itens da fatura permanecerão e só serão processados se incluídos em uma fatura. Quando você cancela uma assinatura, todas as faturas `open` e `draft` dessa assinatura têm a propriedade `auto_advance` definida como `false`. Isso [interrompe a cobrança automática](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection.md) dessas faturas e evita o envio de e-mails de lembretes automáticos. Você ainda pode tentar receber pagamentos e enviar e-mails manualmente. ## Identificar eventos de cancelamento A Stripe envia os eventos a seguir para assinaturas canceladas. | Evento | Descrição | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `customer.subscription.updated` | Enviado para qualquer atualização de assinatura, incluindo quando `cancel_at_period_end` é definido como `true`. | | `customer.subscription.deleted` | Enviado quando uma assinatura é cancelada. O cancelamento pode resultar de uma chamada direta para excluir a assinatura ou quando uma assinatura com `cancel_at_period_end: true` atinge o final de seu período de faturamento. | ## Interromper um cancelamento pendente Você pode interromper um cancelamento agendado usando a [API Update Subscription](https://docs.stripe.com/api/subscriptions/update.md) ou o [Dashboard](https://dashboard.stripe.com/test/subscriptions). Não é possível reativar uma assinatura cancelada. #### Dashboard Para interromper um cancelamento agendado no Dashboard: 1. Na [página Assinaturas](https://dashboard.stripe.com/test/subscriptions), selecione a assinatura que deseja atualizar. 1. Na página Detalhes da assinatura, clique em **Ações** e selecione **Não cancelar**. #### API Para interromper um cancelamento agendado usando a API, defina `cancel_at_period_end` como `false`. Esta ação só afeta assinaturas que não atingiram o final do período de faturamento. ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d cancel_at_period_end=false ``` > Antes da versão [2018-02-28](https://docs.stripe.com/upgrades.md#2018-02-28), *qualquer* parâmetro enviado à [Update Subscription](https://docs.stripe.com/api/subscriptions/update.md) interrompe um cancelamento pendente. ## Definir uma data de cancelamento personalizada Use o parâmetro [cancel_at](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-cancel_at) para cancelar uma assinatura em um carimbo de data e hora futuro. ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d cancel_at=1723766400 ``` Quando você agenda uma data de cancelamento antes do final do período de cobrança, a [current_period_end](https://docs.stripe.com/api/subscription_item/object.md#subscription_item_object-current_period_end) dos itens da assinatura é atualizada para corresponder à data `cancel_at`. Isso cria cobranças proporcionais para a mudança no período atual, a menos que sua atualização [desative](https://docs.stripe.com/billing/subscriptions/prorations.md#disable-prorations) cobranças proporcionais. Para assinaturas `billing_mode=flexible` com `status=trialing`, adicionar, atualizar ou remover o valor `cancel_at` não afeta a data da [trial_end](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-trial_end). Para assinaturas que usam [billing_mode](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-04-30.preview#create_subscription-billing_mode), você pode usar auxiliares de enumeração com o parâmetro `cancel_at` para simplificar o cancelamento de uma assinatura no final de um período de cobrança. Os auxiliares `min_period_end` e `max_period_end` permitem especificar quando cancelar uma assinatura com base nos períodos de cobrança de todos os itens de assinatura. | Evento | Descrição | | ---------------- | --------------------------------------------------------------------------------- | | `min_period_end` | Seleciona o carimbo de data e hora do período de cobrança que termina mais cedo. | | `max_period_end` | Seleciona o carimbo de data e hora do período de cobrança que termina por último. | Esses auxiliares resolvem imediatamente os carimbos de data/hora, reduzindo o risco de alterações posteriores no `current_period_end` de um item afetarem o carimbo de data e hora de cancelamento resolvido. Se você agendar uma data de cancelamento que ocorra em mais de um período no futuro, o ciclo da assinatura permanecerá inalterado até que a assinatura seja renovada para o período que contém a data `cancel_at`. O `items.current_period_end` da renovação é encurtado para corresponder à data `cancel_at`. Por exemplo, seu cliente iniciar uma assinatura licenciada de US$ 120 por ano que será renovada em 1º de janeiro de 2024. O cancelamento da assinatura foi definido para 1º de julho de 2024. O subtotal final da fatura em 1º de janeiro é calculado como US$ 60, e o `items.current_period_end` é 1º de julho. Alterar, adicionar ou remover uma data de cancelamento agendada dentro do período atual atualiza o `items.current_period_end` e cria cobranças proporcionais. No exemplo acima, em 15 de fevereiro, você atualiza a data de cancelamento para 1º de outubro. O término do período atual se torna 1º de outubro, e a Stripe cria cobranças proporcionais de US$ 30 para o trimestre adicional. Para faturar os itens proporcionais imediatamente e não na fatura final em 1º de outubro, passe um [proration_behavior](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-proration_behavior) de `always_invoice` na atualização ou [crie uma fatura avulsa](https://docs.stripe.com/billing/invoices/subscription.md#generating-invoices) separadamente. ## Cancelamento com âncora de ciclo de cobrança A propriedade [âncora do ciclo de cobrança](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-billing_cycle_anchor) da assinatura pode ser alterada se ela tiver acompanhado a data de cancelamento anterior. Durante o primeiro período, a Stripe preserva qualquer âncora que você tiver [definido originalmente](https://docs.stripe.com/billing/subscriptions/billing-cycle.md#new-subscriptions) na assinatura. Quando o primeiro período termina, ou se você não forneceu uma âncora personalizada ao criar a assinatura, a âncora é redefinida para o [início do período atual](https://docs.stripe.com/api/subscription_items/object.md#subscription_item_object-current_period_start). Esse comportamento de redefinição da âncora do ciclo de cobrança só é garantido para assinaturas criadas após junho de 2024. As assinaturas criadas antes dessa data podem apresentar o comportamento herdado: a propriedade [âncora do ciclo de cobrança](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-billing_cycle_anchor) permanece inalterada após cancelamento, remoção ou prorrogação. Adicionar uma data de cancelamento ou mudar uma data para mais perto do horário atual reduz a [âncora do ciclo de faturamento](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-billing_cycle_anchor) para corresponder à nova data de cancelamento. No exemplo acima, em 15 de fevereiro, você atualiza a data de cancelamento para 1º de abril. O término do período e a âncora de faturamento tornam-se 1º de abril e a Stripe cria cobranças proporcionais de -30 USD para creditar o tempo não utilizado de 1º de abril a 1º de julho. ## See also - [Usar períodos de teste](https://docs.stripe.com/billing/subscriptions/trials.md) - [Atualizar assinatura](https://docs.stripe.com/api.md#update_subscription) - [Cancelar assinatura](https://docs.stripe.com/api.md#cancel_subscription)