trial.expired
Se dispara cuando un período de prueba se agota y comienza la facturación regular.
Payload
All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.
The subscription ID.
The customer ID. Returns your externalId if you provided one when creating the customer, otherwise returns the Commet publicId.
Current status — "active" once the billing cycle has activated the subscription.
The plan ID.
The plan name.
ISO 8601 datetime when the trial ended.
{
"event": "trial.expired",
"timestamp": "2026-04-08T01: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",
"trialEndsAt": "2026-04-08T00:00:00.000Z"
}
}Cuándo se dispara
La prueba alcanzó trialEndsAt. El ciclo de facturación activa la suscripción (status: "active"), inicia el primer período de facturación regular y genera la primera factura: invoice.created y los eventos de pago siguen a medida que se procesa el cobro.
El acceso no cambia en este momento: el cliente ya tenía acceso completo durante la prueba y lo mantiene como suscriptor activo. Si el primer cobro falla, se aplica el flujo regular de falla de pago (payment.failed, y subscription.past_due una vez que la suscripción ya fue pagada antes).
¿Cómo está esta guía?