trial.will_end

{ "event": "trial.will_end", "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": "trialing", "planId": "pln_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.

Cuerpo

application/json

string

requerido

event

string

requerido

Allowed value: "trial.will_end"

timestamp

string

requerido

organizationId

string

requerido

mode

enum<string>

requerido

Opciones disponibles:

live,

sandbox

apiVersion

string

requerido

data

object

requerido

Show child attributes

Respuesta

200

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

Introducción

Eventos

trial.will_end

Cuándo se dispara

Cuerpo

Respuesta

​Cuándo se dispara

Cuerpo

Respuesta

Cuándo se dispara