Payload

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

customerIdstring

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

cardobject | 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-04-26T09:00:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-05-25",
  "data": {
    "customerId": "user_123",
    "card": {
      "brand": "mastercard",
      "last4": "5100",
      "expMonth": 8,
      "expYear": 2031
    }
  }
}

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.

Ú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.