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
    }
  }
}

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.

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.