Assinaturas
Excluir uma assinatura
Cancela uma subscription imediatamente.
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.
Detalhes opcionais do cancelamento. Aceita
comment e feedback; reason é
definido pela Chargefy.Valores aceitos em feedback: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 disparasubscription.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.
