Cancelar assinaturas
Você pode cancelar manualmente as assinaturas dos clientes usando a API Subscriptions ou o Dashboard. Se quiser manter a assinatura ativa, mas interromper temporariamente a cobrança de pagamentos, você pode suspender a cobrança de pagamentos. A suspensão da cobrança de um pagamento não afeta o status da assinatura, que é o que recomendamos usar como o acionador para iniciar ou interromper o serviço ao seu cliente.
Assinaturas são canceladas automaticamente depois de até quatro tentativas malsucedidas de cobrar o cliente. Você pode configurar essa opção nas configurações de ciclo de vida da assinatura. Leia mais sobre as configurações de recuperação de receitas (como Smart Retries e e-mails do cliente configuráveis) nos guias.
Cancelar assinaturas
Cancelar assinaturas usando o Dashboard ou a API:
Por padrão, o cancelamento é imediato. Nenhuma fatura adicional é gerada para assinaturas canceladas.
Erro comum
Se você definir uma data de cancelamento personalizada, não será possível fornecer um reembolso. Um rateio de crédito sempre é gerado. Os rateios não são gerados se a data de cancelamento personalizada estiver dentro do período de faturamento atual e proration_behavior
estiver definido none
.
Ratear para faturamento por uso
Quando a assinatura já consumiu parte de um período de faturamento pago, você pode ratear o cancelamento passando o parâmetro prorate.
Quanto um cancelamento é rateado, você tem a opção de emitir uma fatura para:
- Rateamentos pendentes
- Uso por consumo
Se você não ratear a assinatura, todo o uso por consumo será descartado e o cliente não receberá nenhum crédito por possíveis rateios.
Use o parâmetro invoice_now para criar uma fatura final imediatamente. Após cancelar, o cliente pode receber um crédito, que é adicionado ao seu saldo de crédito para ser aplicado a faturas futuras. Para reembolsar seu cliente, emita reembolsos e depois ajuste o saldo da conta de volta para zero. Saiba mais sobre os reembolsos do cliente na nossa página de suporte exclusiva.
Cancelar ao final do ciclo de faturamento atual
Se quiser cancelar a assinatura no final do período de faturamento atual (ou seja, para o período de tempo que o cliente já pagou), atualize a assinatura com o valor cancel_at_period_end
como true
:
Você pode reativar assinaturas agendadas para cancelamento (com o parâmetro cancel_at_period_end
) alterando cancel_at_period_end
para false
. A assinatura pode ser reativada a qualquer momento até o final do período.
Cancelar ao final de um ciclo de faturamento futuro
Para configurar uma assinatura para terminar após um número especificado de ciclos de faturamento, defina um cronograma para ela. Defina a duração do cronograma especificando uma ou mais fases e intervalos e defina seu atributo end_behavior
como cancel
.
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 full amount.
Quando um cliente contesta uma cobrança de assinatura, o ciclo da assinatura continua e pode levar a mais cobranças contestadas. Você pode alterar esse comportamento no Stripe Dashboard para que as assinaturas sejam canceladas após uma contestação. Em Gerenciar pagamentos disputados, selecione cancelar a assinatura imediatamente sem cobrança proporcional ou cancelar a assinatura ao final do período. As alterações da assinatura são aplicadas em até uma hora.
Se você optar por cancelar imediatamente, o cancelamento será imediato sem qualquer cobrança proporcional. Não é possível reiniciar uma assinatura cancelada. Portanto, para continuar a cobrar o cliente, você precisa criar outra assinatura.
Quando você opta por cancelar no final do período, cancel_at_period_end é definido como true
e a assinatura é cancelada no final do período de faturamento atual. Dessa forma, você tem algum tempo para tentar resolver o processo de contestação antes do cancelamento.
Assinaturas gerenciadas com cronogramas 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
Quando uma assinatura tem itens de fatura pendentes criados por você, esses itens podem ser cobrados do cliente se o cancelamento estiver configurado para emitir uma fatura final ou se o cliente tiver outra assinatura ativa. Para evitar essa cobrança, exclua manualmente os itens da fatura.
Da mesma forma, qualquer uso relatado durante o período de faturamento é cobrado no final desse período. Para evitar uma cobrança final por uso, atualize a assinatura e remova o preço por consumo usando o parâmetro clear_usage.
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 uma assinatura é cancelada, a propriedade auto_advance
de todas as faturas open
e draft
é definida como false
. Isso ocorre para evitar tentativas de pagamento inesperada e e-mails de lembrete. A cobrança automática dessas faturas é suspensa. Você pode tentar cobrar o pagamento e enviar e-mails manualmente.
Identificar eventos de cancelamento
A Stripe envia um evento customer.subscription.deleted
quando a assinatura do cliente é cancelada imediatamente. Quando a propriedade request
do evento customer.subscription.deleted
não é null
, isso indica que o cancelamento foi realizado por sua solicitação (em vez de automaticamente de acordo com as configurações da assinatura).
Se você cancelar uma assinatura no final do período de faturamento (ou seja, definir cancel_at_period_end
como true
), um evento customer.subscription.updated
será acionado imediatamente. Esse evento reflete a mudança no valor de cancel_at_period_end
da assinatura. O cancelamento real da assinatura no final do período gera um evento customer.subscription.deleted
.
Interromper um cancelamento pendente
Se você agendar o cancelamento de uma assinatura atualizando cancel_at_period_end
para true
e a assinatura ainda não tiver atingido o final do período de faturamento, será possível interromper o cancelamento atualizando cancel_at_period_end
para false
.
Observação
Antes da versão 2018-02-28, qualquer parâmetro enviado à API Update Subscription interrompe um cancelamento pendente.
Você também pode interromper um cancelamento agendado usando a opção Reativar assinatura do Dashboard.
Após o cancelamento de uma assinatura, não é possível reativá-la.