subscription.past_due

{ "event": "subscription.past_due", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "subscriptionId": "sub_1a2b3c4d", "customerId": "user_123", "status": "past_due", "invoiceId": "inv_n4o5p6", "invoiceNumber": "INV-0043" } }

When this fires

A recurring charge failed on a subscription that has been paid before. Commet sets the status to past_due and enters dunning.

past_due is a permissive grace window — features, usage, and seats keep working. Only purchases and plan changes are blocked. Usage accrues as debt during this window.

Commet retries the charge on day 1, day 3, day 5, and day 7 after the failure (4 retries). If a retry succeeds the subscription returns to active. If all 4 retries fail the subscription is canceled.

payment.failed fires alongside this event with the charge failure details (failureCode, failureMessage). Use subscription.past_due to drive your access state and payment.failed to drive recovery messaging.

First-checkout card declines do NOT trigger this event — a subscription that was never paid moves back to pending_payment instead.

Body

application/json

string

required

event

string

required

Allowed value: "subscription.past_due"

timestamp

string

required

organizationId

string

required

mode

enum<string>

required

Available options:

live,

sandbox

apiVersion

string

required

data

object

required

Show child attributes

Response

200

Return any 2xx status code to acknowledge receipt of the event.

Overview

Events

subscription.past_due

When this fires

Body

Response

​When this fires

Body

Response

When this fires