Pular para o conteúdo principal
Cancela uma subscription imediatamente. Esse é o endpoint de remoção do recurso: a assinatura sai de uso agora, mas o registro continua existindo para preservar histórico financeiro, invoices e webhooks. Depois do DELETE, a Chargefy atualiza a assinatura para status: "canceled", preenche canceled_at, remove qualquer cancelamento agendado, cancela jobs pendentes de trial/renovação e dispara subscription.canceled. A resposta retorna o objeto subscription completo atualizado. Por padrão, faturas que já estavam em aberto continuam open e cobráveis depois do cancelamento — o cancelamento não apaga o que o cliente já devia. Envie void_open_invoices: true para anular, no mesmo passo, as faturas cujo pagamento ainda pode ser interrompido. Uma cobrança já em processamento ou aguardando confirmação mantém sua fatura open até o resultado. Isso não impede o cancelamento da assinatura nem permite que um pagamento posterior a reative.
Este endpoint é para encerrar agora. Quando a assinatura tem prazo combinado, declare o prazo em vez de agendar um clique: use o endpoint de update com cancel_at_period_end: true para encerrar no fim do período atual, ou cancel_at para encerrar numa data específica. Os dois campos também são aceitos na criação, o que permite vender com prazo em uma requisição só.Para desfazer, envie cancel_at_period_end: false ou cancel_at: null.
string
obrigatório
ID da subscription (sub_*).
object
Detalhes opcionais do cancelamento. Aceita comment e feedback; reason é definido pela Chargefy.Valores aceitos em feedback:
boolean
padrão:"false"
Quando true, anula as faturas em aberto cujo pagamento pode ser interrompido e cancela os respectivos payment intents. Tentativas em processamento ou com resultado ainda desconhecido são preservadas, com a fatura open. Boletos já emitidos seguem o cancelamento assíncrono descrito em Cancelar uma fatura. Por padrão (false), as faturas em aberto permanecem cobráveis após o cancelamento.

Webhooks

O cancelamento imediato dispara subscription.canceled com a subscription completa em data.object. Com void_open_invoices: true, cada fatura anulada dispara invoice.voided e cada payment intent cancelado dispara payment.intent.canceled, antes do subscription.canceled. Quando o cancelamento de um boleto ainda aguarda confirmação, o payment intent dispara payment.intent.updated; payment.intent.canceled só é enviado após a confirmação. Faturas preservadas por uma tentativa em andamento não disparam invoice.voided.