Evento payment.method.created

Evento `payment.method.created`

Disparado quando uma confirmação de setup_intent materializa um novo payment_method salvo. Use este evento para criar o registro local da credencial salva que poderá ser usada em cobranças futuras. O payload traz apenas dados seguros para identificação, como bandeira, validade e quatro últimos dígitos do cartão. data.object usa o mesmo shape do objeto payment_method. O número completo e o código de segurança do cartão nunca são armazenados nem retornados.

Este evento confirma que a credencial foi criada. Para saber se ela ficou ligada a um customer específico, observe o campo customer no objeto e processe também eventos payment.method.attached quando eles forem entregues.

Quando acontece

Situação	Como aparece no payload
Setup intent materializa um método salvo	`data.object.id` traz o novo `pm_*`.
Método nasce já ligado a um customer	`data.object.customer` traz o `cus_*`.
Cartão foi tokenizado com sucesso	`card.brand`, `card.last4` e validade ficam preenchidos quando disponíveis.

Como processar

Registre o id do evento (evt_*) para processar o webhook de forma idempotente.
Faça upsert pelo data.object.id (pm_*).
Relacione o método ao customer quando o campo vier preenchido.
Exiba o cartão salvo somente pelos dados não sensíveis em card.
Use metadata para correlacionar a credencial com seu sistema quando você tiver enviado valores livres.

Campos importantes

Campo	O que observar
`data.object.id`	Identificador público do payment method.
`customer`	Customer ligado ao método ou `null` quando ainda não houver vínculo.
`billing_details`	Dados de cobrança associados ao método.
`card.brand` / `card.last4`	Identificação segura do cartão salvo.
`card.exp_month` / `card.exp_year`	Validade do cartão.
`type`	Tipo do método; atualmente `credit_card`.
`updated_at`	Vem `null` enquanto o método ainda não foi atualizado.

Tipos de método

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

Exemplo de payload

{
  "id": "evt_R9ReqP1KGprcaWdP",
  "object": "event",
  "created_at": "2026-05-16T18:32:00Z",
  "data": {
    "object": {
      "id": "pm_k1MGsv6JygF2PnEB",
      "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_H5AL5jgH2JfCbRba",
      "livemode": true,
      "metadata": {},
      "type": "credit_card",
      "updated_at": null
    }
  },
  "livemode": true,
  "organization": "org_foA7BNr2WHG5Pavt",
  "request": {
    "id": null
  },
  "type": "payment.method.created"
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Evento payment.method.created