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

When this fires

After a payment failure puts a subscription in past_due, Commet retries the outstanding invoice on the dunning schedule. When the final retry fails, the invoice is marked uncollectible and the subscription is canceled — this event marks that terminal outcome.

It is the end of the dunning flow: payment.recovered will not follow, and subscription.canceled fires alongside it. Revoke access when you receive this event.