> ## Documentation Index
> Fetch the complete documentation index at: https://commet.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# payment_method.updated

> A customer's default payment method was replaced.

## When this fires

Fired when a customer replaces their default payment method through the customer portal. The new method applies to all of the customer's subscriptions.

The `card` object carries display metadata only — brand, last 4 digits, and expiration. Full card numbers never leave the payment provider. When the new method is not a card or its details cannot be retrieved, `card` is `null`.

`paymentMethod` identifies the newly saved instrument (`card` or `mercado_pago`; OXXO never leaves a saved instrument). It does not describe which method paid an earlier transaction.

Use it to refresh the card shown in your billing UI. A payment method update is also a strong recovery signal for past-due subscriptions — the customer typically updates their card to fix a failed payment.


## OpenAPI

````yaml /openapi/en/webhooks/2026-08-27.json webhook payment_method.updated
openapi: 3.1.0
info:
  title: Commet Webhooks
  version: '2026-08-27'
  description: >-
    Outbound webhook events emitted by the Commet API. Each event is delivered
    as a signed POST to your configured endpoints.
servers: []
security: []
paths: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.