Se dispara cuando una suscripción entra en su período de prueba. Otorgá el acceso aquí.

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 ends.

{
  "event": "trial.started",
  "timestamp": "2026-06-23T14:30:00.000Z",
  "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f",
  "mode": "live",
  "apiVersion": "2026-07-31",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "status": "trialing",
    "planId": "pln_pro_monthly",
    "planName": "Pro",
    "trialEndsAt": "2026-04-08T00:00:00.000Z"
  }
}

Ciclo de vida de la prueba

Las pruebas en Commet recopilan un método de pago en el checkout, por lo que cada prueba tiene un camino claro hacia los ingresos:

Momento	Evento	Qué hacer
El checkout se completa con días de prueba	`trial.started`	Otorgá acceso completo.
3 días antes de que termine la prueba	`trial.will_end`	Recordale al cliente que la facturación comienza pronto.
El cliente hace upgrade durante la prueba	`trial.converted`	La prueba termina antes de tiempo, el plan pago comienza ahora.
La prueba se agota	`trial.expired`	La facturación regular comienza automáticamente.

Las suscripciones con status: "trialing" tienen acceso completo: tratalas como active en tus verificaciones de permisos.