Períodos de prueba

Un trial es una fase free_trial en una Offer. No es un sistema de descuentos separado.

La fase registra cuánto se retrasa el primer cobro. El canal de aplicación decide quién la recibe:

Los Promo Codes no pueden distribuir fases de trial.

Trial reutilizable

Creá una Offer y reutilizala:

const trialOffer = await commet.offers.create({
  name: 'Onboarding de 14 días',
  phases: [
    { type: 'free_trial', durationDays: 14 },
  ],
})

Vinculala a un precio base desde el Dashboard para selección introductoria automática, o enviala directamente:

await commet.subscriptions.create({
  customerId: 'user_123',
  planCode: 'pro',
  offerId: trialOffer.id,
})

Una Offer también puede continuar con fases promocionales pagas después del trial.

Trial específico del customer

Usá customTrialDays cuando las condiciones sean exclusivas de una suscripción y no necesiten una identidad reutilizable en el catálogo:

await commet.subscriptions.create({
  customerId: 'user_123',
  planCode: 'pro',
  customTrialDays: 21,
})

Commet persiste el trial aceptado como una Offer Application custom con una fase free_trial.

Omitir un trial automático

await commet.subscriptions.create({
  customerId: 'user_123',
  planCode: 'pro',
  skipTrial: true,
})

offerId no puede combinarse con customTrialDays ni skipTrial: true; la Offer explícita ya define la secuencia completa.

Checkout y facturación

El customer ingresa un medio de pago durante checkout, pero no se cobra inmediatamente. Cuando el setup termina:

1. la suscripción pasa a trialing;
2. trialEndsAt registra el final de la fase gratuita;
3. Commet cobra el precio seleccionado actual al terminar el trial;
4. se activa la siguiente fase de la Offer, si existe.

Las fases aceptadas de la Offer son inmutables, pero el precio seleccionado del catálogo no. Si el precio cambia durante el trial, el primer cobro usa el valor actual del precio seleccionado.

Relacionado

• Offers
• Introductory Offers
• Promotional Offers
• Cómo funcionan los trials
• Manejar pagos fallidos