Skip to main content
Webhooks de assinatura usam um envelope próprio. O event de topo é sempre subscription; o nome concreto do evento fica em data.event_type.

Exemplo de payload entregue

Eventos de falha usam os mesmos campos da assinatura e também podem trazer contexto de retentativa, como attempt_number e failure_reason.

Eventos emitidos hoje

  • subscription.created
  • subscription.started
  • subscription.renewed
  • subscription.updated
  • subscription.canceled
  • subscription.payment_failed
  • subscription.past_due
  • subscription.trial_will_end
  • subscription.chargeback_received

Guia de tratamento

  • Faça deduplicação pelo id do evento no topo.
  • Use data.event_type para encaminhar cada evento ao handler correto.
  • Use data.status para o estado atual da assinatura.
  • Use latest_transaction para a transação de cobrança ligada ao evento.
  • Use o UUID em data.id como identificador da assinatura.
  • Reconcilie com GET /v2/subscriptions/{id} se a entrega ou o processamento for interrompido.

Leia a seguir