Skip to main content
Um event registra algo que aconteceu em um recurso da sua conta: um cliente foi criado, uma cobrança foi aprovada, uma assinatura foi cancelada. Cada acontecimento gera um event. Esse event existe independente de você ter endpoints de webhook configurados. Se houver endpoints inscritos, a Chargefy cria entregas separadas para cada endpoint; se não houver, o event continua disponível para consulta pela API. Use events para conciliar o estado do seu sistema com a Chargefy. Use entregas de webhook para debugar envio, retry, status HTTP e resposta do seu endpoint.
event e entrega de webhook são coisas diferentes. O event é o acontecimento; a entrega é uma tentativa de enviar esse acontecimento para um endpoint.

​
Como usar

Preciso…Use
Saber o que aconteceutype
Processar sem duplicar trabalhoid do event
Ler o recurso no estado atualdata.object
Saber o que mudou em um updatedata.previous_attributes
Saber de qual organização veioorganization
Investigar falha de envio HTTPlogs de entrega em Webhooks
Events ficam disponíveis por 30 dias. Depois desse período, eles deixam de aparecer nas consultas. Veja Webhooks para o formato de entrega e Tipos de evento para a lista completa de type.

​
Objeto event

{
  "id": "evt_123",
  "object": "event",
  "created_at": "2026-05-27T14:09:27Z",
  "data": {
    "object": {
      "id": "cus_123",
      "object": "customer",
      "created_at": "2026-05-27T14:09:20Z",
      "email": "nome@email.com",
      "livemode": true,
      "metadata": {},
      "name": "Cliente"
    },
    "previous_attributes": {
      "name": "Nome anterior"
    }
  },
  "livemode": true,
  "organization": "org_123",
  "request": {
    "id": "req_123"
  },
  "type": "customer.updated"
}
​
id
string
ID único do event (evt_*). Use esse valor como chave de idempotência no seu sistema: se o mesmo event chegar mais de uma vez por retry, processe apenas uma vez.
​
object
string
Sempre event.
​
created_at
string
Timestamp ISO 8601 de quando o acontecimento foi registrado.
​
data
object
Contém o objeto afetado e, em eventos de atualização, o que mudou.
​
livemode
boolean
true para eventos do ambiente de produção, false para o de teste.
​
organization
string | null
Organização que originou o evento. Em integrações de plataforma, esse campo aponta para a organização conectada onde o acontecimento ocorreu.
​
request
object
Referência à chamada de API que originou o evento, quando aplicável.
​
type
string
Tipo do evento, ex.: customer.updated. Veja a lista completa.

​
Event vs entrega de webhook

Um event pode ter zero, uma ou várias entregas:
CenárioResultado
Nenhum endpoint inscritoO event é criado e aparece na API, mas não há entrega.
Um endpoint inscritoO event é criado e uma entrega é enviada para esse endpoint.
Vários endpoints inscritosO event é criado uma vez e cada endpoint recebe sua própria entrega.
Essa separação evita duplicação no ledger de events. Você lista acontecimentos em /v1/events; você investiga tentativas HTTP nas telas e logs de Webhooks.