Aplica automáticamente una Offer existente a nuevas suscripciones elegibles.
Una Introductory Offer no es un tipo de Offer distinto. Es una Offer existente vinculada a un precio base del plan mediante una ubicación introductoria.
Esa ubicación agrega dos comportamientos:
Las variantes seleccionables heredan la ubicación introductoria de su precio base.
Una Offer usada como introductoria puede contener:
free_trial opcional al comienzo.percentage o amount_off.No puede usar fixed_price, varias fases de descuento ni un descuento sin vencimiento.
const onboarding = await commet.offers.create({
name: 'Onboarding Starter',
phases: [
{ type: 'free_trial', durationDays: 14 },
{ type: 'percentage', durationCycles: 3, percentage: 3000 },
],
})En el Dashboard, abrí el precio del plan y elegí Add intro offer para vincular la Offer existente. Un precio base puede tener una sola ubicación introductoria a la vez.
La elegibilidad automática actual excluye a un customer que ya tenga una suscripción active o past_due en la organización. Otros estados históricos no producen un bloqueo de por vida.
await commet.subscriptions.create({
customerId: 'user_123',
planCode: 'starter',
})Cuando se omite offerId, Commet resuelve el precio seleccionado y aplica su Introductory Offer si el customer es elegible.
Un offerId explícito aplica esa Offer directamente. No puede combinarse con promoCode, customTrialDays ni skipTrial: true.
trialDays, customTrialDays y skipTrial siguen siendo atajos compatibles de la API. Internamente, una prueba aceptada se registra como una fase free_trial en la Offer Application. Preferí Offers de catálogo cuando las mismas condiciones deban tener nombre, reutilizarse, inspeccionarse o distribuirse de forma consistente.
¿Cómo está esta guía?