Evento subscription.canceled
Disparado quando uma subscription passa para canceled, seja por cancelamento
imediato ou por um cancelamento agendado que chegou ao fim do período.
Use este evento para encerrar acesso recorrente, registrar o motivo de churn e
parar qualquer automação interna ligada à assinatura.
canceled é estado terminal. Uma assinatura cancelada não renova, não agenda
novos ciclos e não volta para active; para reativar o cliente, crie uma nova
assinatura.Quando acontece
Como processar
- Registre o
iddo evento (evt_*) para processar o webhook de forma idempotente. - Use
data.object.id(sub_*) para marcar a assinatura como encerrada no seu sistema. - Remova ou degrade acesso recorrente quando
statusforcanceled. - Salve
ended_at,canceled_atecancellation_detailspara auditoria e métricas de churn. - Não tente cobrar novos ciclos dessa assinatura após receber este evento.

