Skip to main content

​
Evento customer.updated

Disparado quando campos de um cliente mudam — via POST /v1/customers/:id ou durante o checkout/cobrança automática (ex.: enriquecimento de billing_address ou document). data.object carrega o customer completo no estado atual. data.previous_attributes traz só os campos que mudaram, com os valores anteriores. 
{
  "id": "evt_123",
  "object": "event",
  "created_at": "2026-05-16T15:02:10Z",
  "data": {
    "object": {
      "id": "cus_123",
      "object": "customer",
      "billing_address": {
        "city": "São Paulo",
        "country": "BR",
        "line1": "Av. Paulista, 1000",
        "line2": null,
        "postal_code": "01310-100",
        "state": "SP"
      },
      "billing_name": null,
      "created_at": "2026-05-16T14:09:27Z",
      "document": "12345678901",
      "document_type": "cpf",
      "email": "nome@email.com",
      "livemode": true,
      "metadata": {
        "reference_id": "ref_456"
      },
      "name": "Cliente Exemplo",
      "phone": "+5511999990000",
      "updated_at": "2026-05-16T15:02:10Z"
    },
    "previous_attributes": {
      "billing_address": null,
      "phone": null
    }
  },
  "livemode": true,
  "organization": "org_123",
  "request": {
    "id": null
  },
  "type": "customer.updated"
}