Evento payment.method.updated

Evento `payment.method.updated`

Disparado quando um payment_method é atualizado via POST /v1/payment-methods/:id. data.object carrega o payment method completo no estado atual. data.previous_attributes traz apenas os campos públicos alterados, com os valores anteriores. Use este evento para manter metadata, dados de cobrança e exibição do método salvo em sincronia. Para persistência, use o objeto completo em data.object; para auditoria, use o diff em data.previous_attributes.

Atualizações de payment method não expõem número completo do cartão nem código de segurança. O payload continua limitado aos dados seguros do objeto público.

Quando acontece

Situação	Como aparece no payload
Metadata do método foi atualizada	`previous_attributes.metadata` mostra o valor anterior.
Dados públicos de cobrança mudaram	`billing_details` aparece atualizado em `data.object`.
O método recebeu nova atualização pública	`data.object.updated_at` traz o horário da mudança.

Como processar

Registre o id do evento (evt_*) para processar o webhook de forma idempotente.
Atualize seu registro local usando data.object, que contém o payment method completo.
Use data.previous_attributes para auditoria e notificações condicionais.
Continue exibindo o cartão apenas por card.brand, card.last4, card.exp_month e card.exp_year.
Não infira troca de customer a partir de campos ausentes no diff; leia sempre data.object.customer.

Campos importantes

Campo	O que observar
`data.object.id`	Payment method atualizado.
`data.previous_attributes`	Valores anteriores dos campos que mudaram.
`customer`	Customer atualmente ligado ao método ou `null`.
`billing_details`	Dados de cobrança atuais.
`metadata`	Metadata atual; o valor anterior aparece no diff quando muda.
`card`	Dados seguros e não sensíveis do cartão.
`updated_at`	Horário da atualização.

Tipos de método

Valor	Descrição
`credit_card`	Cartão de crédito.

Exemplo de payload

{
  "id": "evt_Zomrey8n6kWemJC1",
  "object": "event",
  "created_at": "2026-05-16T18:45:00Z",
  "data": {
    "object": {
      "id": "pm_pq6JZVbfHiWi8CWu",
      "object": "payment_method",
      "billing_details": {
        "address": null,
        "email": "nome@email.com",
        "name": "Cliente Exemplo",
        "phone": null
      },
      "card": {
        "brand": "visa",
        "exp_month": 12,
        "exp_year": 2030,
        "last4": "4242"
      },
      "created_at": "2026-05-16T18:32:00Z",
      "customer": "cus_pX2Sg5CbcFUHYe3f",
      "livemode": true,
      "metadata": {},
      "type": "credit_card",
      "updated_at": "2026-05-16T18:45:00Z"
    },
    "previous_attributes": {
      "metadata": {}
    }
  },
  "livemode": true,
  "organization": "org_XpmoUgCaffA7fBW4",
  "request": {
    "id": null
  },
  "type": "payment.method.updated"
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Evento payment.method.updated