Eventos de Webhook

O sistema emite eventos para todas as operações significativas. Cada organização pode se inscrever nos tipos relevantes.

Formato do Payload

{
  "id": "9f8b2c14-3a5d-4e77-9b10-2c6e5f0a1d33",
  "type": "payment.succeeded",
  "created_at": "2026-04-05T10:30:00.000Z",
  "data": { },
  "changes": {
    "status": { "from": "open", "to": "paid" }
  },
  "environment": "production",
  "version": "2026-03-01"
}

• id é o UUID do evento e created_at é ISO 8601 (UTC). Todos os campos do envelope usam snake_case.
• data traz o recurso serializado no mesmo formato da API v1, também em snake_case.
• changes é opcional: aparece nos eventos que carregam mudanças de campos (.db.updated e *.status_changed), no formato {"campo": {"from": valorAntigo, "to": valorNovo}}.

Tipos de Eventos

Assinaturas (11 tipos)

Evento	Descrição
subscription.db.created	Assinatura criada
subscription.db.updated	Assinatura atualizada
subscription.db.deleted	Assinatura deletada
subscription.status_changed	Status alterado
subscription.canceled	Cancelada
subscription.paused	Pausada
subscription.resumed	Retomada
subscription.renewed	Renovada
subscription.trial_ending	Trial prestes a expirar
subscription.past_due	Em atraso

Faturas (10 tipos)

Evento	Descrição
invoice.db.created	Fatura criada
invoice.db.updated	Fatura atualizada
invoice.db.deleted	Fatura deletada
invoice.status_changed	Status alterado
invoice.finalized	Finalizada
invoice.paid	Paga
invoice.payment_failed	Pagamento falhou
invoice.voided	Anulada
invoice.uncollectible	Marcada como incobrável
invoice.overdue	Vencida

Pagamentos (8 tipos)

Evento	Descrição
payment.db.created	Pagamento criado
payment.db.updated	Pagamento atualizado
payment.db.deleted	Pagamento deletado
payment.status_changed	Status alterado
payment.processing	Em processamento
payment.succeeded	Bem-sucedido
payment.failed	Falhou
payment.refunded	Reembolsado

Métodos de Pagamento (5 tipos)

Evento	Descrição
payment_method.db.created	Método criado
payment_method.db.updated	Método atualizado
payment_method.db.deleted	Método removido
payment_method.status_changed	Status alterado
payment_method.expired	Expirado

Planos (4 tipos)

Evento	Descrição
plan.db.created	Plano criado
plan.db.updated	Plano atualizado
plan.db.deleted	Plano deletado
plan.archived	Plano arquivado

Produtos (6 tipos)

Evento	Descrição
product.db.created	Produto criado
product.db.updated	Produto atualizado
product.db.deleted	Produto deletado
product.status_changed	Status alterado
product.archived	Arquivado
product.restored	Restaurado

Contas de Cobrança (5 tipos)

Evento	Descrição
billing_account.db.created	Conta criada
billing_account.db.updated	Conta atualizada
billing_account.db.deleted	Conta deletada
billing_account.status_changed	Status alterado
billing_account.suspended	Conta suspensa

Empresa, Clientes e Outros

• company.db.created / db.updated / db.deleted / status_changed
• customer.db.created / db.updated / db.deleted

Total: 56 tipos de eventos