Payload

Todos los webhooks comparten una estructura principal. Los datos específicos del evento están dentro de data .

customerIdstring

The customer ID. Returns your externalId if you provided one when creating the customer, otherwise returns the Commet publicId.

paymentMethodPaymentMethod | null

The payment method: card, oxxo, or mercado_pago. Null when unknown.

cardWebhookCardInfo | null

Card display metadata for the new method: brand, last4, expMonth, expYear. Null when the method is not a card or its details cannot be retrieved.

{
  "event": "payment_method.updated",
  "timestamp": "2026-06-23T14:30:00.000Z",
  "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f",
  "mode": "live",
  "apiVersion": "2026-08-27",
  "data": {
    "customerId": "user_123",
    "paymentMethod": "mercado_pago",
    "card": null
  }
}

Cuándo se dispara

Se dispara cuando un cliente reemplaza su método de pago predeterminado a través del portal del cliente. El nuevo método se aplica a todas las suscripciones del cliente.

El objeto card solo incluye metadatos de visualización — marca, últimos 4 dígitos y vencimiento. Los números de tarjeta completos nunca salen del proveedor de pagos. Cuando el nuevo método no es una tarjeta o sus detalles no se pueden obtener, card es null.

paymentMethod identifica el medio que se acaba de guardar (card o mercado_pago; OXXO no deja un medio guardado). No describe con qué medio se pagó una transacción anterior.

Úsalo para actualizar la tarjeta que se muestra en tu UI de facturación. La actualización de un método de pago también es una fuerte señal de recuperación para suscripciones vencidas — el cliente normalmente actualiza su tarjeta para resolver un pago fallido.

payment_method.updated

Se reemplazó el método de pago predeterminado de un cliente.