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.

provider"stripe" | "commet" | "dlocal"

The payment provider the charge was routed to: stripe, commet, or dlocal.

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-08-27",
  "data": {
    "invoiceId": "inv_n4o5p6",
    "invoiceNumber": "INV-0043",
    "customerId": "user_123",
    "subscriptionId": "sub_1a2b3c4d",
    "provider": "stripe",
    "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.