Evento subscription.updated
Disparado quando uma subscription muda. data.object carrega o objeto
completo no estado atual. data.previous_attributes traz apenas os campos que
mudaram, com os valores anteriores.
Use este evento para manter seu sistema sincronizado com mudanças de status,
método de pagamento, período, cancelamento agendado, metadata ou itens da
assinatura.
data.object é sempre a assinatura completa depois da mudança. Use
data.previous_attributes para auditoria e notificações condicionais, mas
atualize seu estado local a partir de data.object.Quando acontece
Como processar
- Registre o
iddo evento (evt_*) para processar o webhook de forma idempotente. - Use
data.object.id(sub_*) para atualizar a assinatura salva no seu sistema. - Atualize acesso e cobrança com base em
data.object.status, não apenas nos campos do diff. - Use
previous_attributespara decidir se deve enviar e-mail, registrar auditoria ou acionar fluxos internos. - Quando
cancel_atmudar, reflita a data de término na sua UI. Ela cobre os três caminhos — prazo declarado na venda, agendamento que encerra ecancel_at_period_end—, então observar só o booleano deixa passar os dois primeiros. - Quando
statusmudar paraactive, reative acesso que estava bloqueado por pagamento pendente.

