Evento predictivo que se dispara una vez, 3 días antes de que termine una prueba.

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 "trialing" for this event.

planIdstring

The plan ID.

planNamestring

The plan name.

trialEndsAtstring

ISO 8601 datetime when the trial will end.

{
  "event": "trial.will_end",
  "timestamp": "2026-04-05T06:00:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-05-25",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "status": "trialing",
    "planId": "plan_pro_monthly",
    "planName": "Pro",
    "trialEndsAt": "2026-04-08T00:00:00.000Z"
  }
}

Cuándo se dispara

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

Usalo para recordarle al cliente que la facturación comienza el trialEndsAt: el momento más efectivo para prevenir el churn involuntario y los cobros sorpresa.

Si la fecha de fin de la prueba cambia después de que se disparó este evento (por ejemplo, el cliente se convierte antes de tiempo), trial.converted o trial.expired reflejan el resultado final.