Promotional Offers

Una Promotional Offer es una Offer con purpose: 'promotional'. Tu integración la selecciona explícitamente mediante offerId, o un Promo Code la referencia para que el cliente pueda ingresarlo.

Fases soportadas

Las Promotional Offers soportan una o más fases ordenadas:

• percentage reduce el precio base del plan usando basis points.
• amount_off resta un valor explícito para cada moneda soportada en el checkout.
• fixed_price reemplaza el precio base por un valor explícito para cada moneda soportada en el checkout.

Cada fase tiene un durationCycles positivo. Las Promotional Offers no pueden contener una fase de free trial.

const offer = await commet.offers.create({
  name: 'Launch sequence',
  purpose: 'promotional',
  planPriceIds: ['pp_pro_monthly'],
  phases: [
    { type: 'percentage', durationCycles: 2, percentage: 5000 },
    { type: 'percentage', durationCycles: 2, percentage: 2500 },
  ],
})

Las fases con valores monetarios deben definir cada moneda soportada en el checkout. Commet no reutiliza silenciosamente un valor en USD para otra moneda.

Seleccionar una Offer

Enviá el ID al crear la suscripción:

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

Un offerId promocional explícito reemplaza la Introductory Offer automática. No puede combinarse con promoCode, customTrialDays ni skipTrial: true.

Las operaciones soportadas de cambio de plan, preview y reactivación también aceptan offerId. La Offer debe estar activa, dentro de su ventana de disponibilidad y asociada al precio base resuelto.

Distribuir con Promo Codes

Un Promo Code referencia una Promotional Offer. Una Offer referenciada por un código debe conservar una sola fase percentage o amount_off; no puede tener varias fases ni usar fixed_price.

Usá offerId cuando tu aplicación decide quién recibe el precio. Usá un Promo Code cuando el cliente ingresa un código de campaña en el checkout.

Términos aceptados

El checkout guarda una Offer Application inmutable. Los cambios posteriores en el catálogo afectan solamente futuras aceptaciones. El descuento modifica el precio base del plan; el overage de uso, los seats y los add-ons no reciben descuento.

Relacionado

• Offers
• Introductory Offers
• Promo Codes
• Administrar suscripciones