Payload

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

subscriptionIdstring

The subscription the payment method was saved for.

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: brand, last4, expMonth, expYear. Null when the method is not a card or its details cannot be retrieved.

{
  "event": "payment_method.attached",
  "timestamp": "2026-03-25T14:32:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-05-25",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "card": {
      "brand": "visa",
      "last4": "4242",
      "expMonth": 12,
      "expYear": 2030
    }
  }
}

Cuándo se dispara

Se dispara cuando Commet registra un método de pago para una suscripción: después de un checkout pago, cuando un trial comienza con una tarjeta en archivo, o cuando se completa un checkout de total cero con un método de pago guardado.

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 método guardado no es una tarjeta o sus detalles no se pueden obtener, card es null.

Úsalo para mostrar la tarjeta guardada en tu propia UI de facturación o para confirmarle al cliente que su método de pago está en archivo.