Evento predictivo que se dispara una vez, 3 días antes de que se renueve una suscripción.

Payload

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

subscriptionIdstring

The subscription ID.

customerIdstring

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

statusstring

Always "active" for this event.

planIdstring

The plan ID.

planNamestring

The plan name.

billingIntervalstring | null

The billing interval (monthly, yearly).

currentPeriodEndstring

ISO 8601 datetime when the current period ends and the renewal invoice is issued.

{
  "event": "invoice.upcoming",
  "timestamp": "2026-04-22T06:00:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-05-25",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "status": "active",
    "planId": "plan_pro_monthly",
    "planName": "Pro",
    "billingInterval": "monthly",
    "currentPeriodEnd": "2026-04-25T00:00:00.000Z"
  }
}

Cuándo se dispara

Un escaneo diario encuentra suscripciones activas que se renuevan dentro de los próximos 3 días y emite este evento una vez por renovación. La clave de idempotencia se deriva de la suscripción y la fecha de renovación, por lo que volver a ejecutar el escaneo nunca envía un duplicado.

Las suscripciones con una cancelación programada quedan excluidas — no se emitirá ningún recibo de renovación para ellas.

Úsalo para notificar al cliente antes de que se le cobre. El payload intencionalmente no incluye un monto: los cargos basados en consumo solo son definitivos al momento de la renovación, cuando invoice.created entrega el recibo real.