Payload

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

invoiceIdstring

The invoice whose retries were exhausted.

invoiceNumberstring

The human-readable invoice number.

customerIdstring

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

subscriptionIdstring

The subscription ID.

reasonstring

Terminal dunning reason, usually the last processor decline code or "dunning_exhausted".

{
  "event": "payment.retry_failed",
  "timestamp": "2026-06-23T14:30:00.000Z",
  "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f",
  "mode": "live",
  "apiVersion": "2026-07-11",
  "data": {
    "invoiceId": "inv_n4o5p6",
    "invoiceNumber": "INV-0043",
    "customerId": "user_123",
    "subscriptionId": "sub_1a2b3c4d",
    "reason": "card_declined"
  }
}

Cuándo se dispara

Después de que una falla de pago deja una suscripción en past_due, Commet reintenta el recibo pendiente según el calendario de dunning. Cuando el último reintento falla, el recibo se marca como incobrable y la suscripción se cancela — este evento marca ese desenlace terminal.

Es el final del flujo de dunning: payment.recovered no va a seguir, y subscription.canceled se dispara junto con este evento. Revoca el acceso cuando lo recibas.