Evento subscription.pending.update.applied
Disparado quando uma pending update é aplicada à subscription. data.object
carrega o objeto subscription completo no estado atual. data.previous_attributes
traz a pending update anterior e os demais campos alterados.
Pending updates são alterações que ficaram aguardando uma condição antes de
entrar em vigor, como pagamento de uma invoice de ajuste. Use este evento para
trocar plano, quantidade ou itens no seu sistema somente quando a mudança foi
efetivamente aplicada.
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. - Aplique acesso, limites e cobrança com base em
data.object.items.data[], que já é o estado novo. - Use
previous_attributes.pending_updatepara auditoria ou para fechar uma solicitação pendente no seu sistema. - Não aplique a mudança duas vezes se você também recebeu eventos da invoice relacionada.

