> ## Documentation Index
> Fetch the complete documentation index at: https://commet.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Introductory Offers

> 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:

* Commet selecciona la Offer automáticamente cuando no se envía un reemplazo explícito.
* Commet comprueba la elegibilidad introductoria antes de aplicarla.

Las variantes seleccionables heredan la ubicación introductoria de su precio base.

## Fases compatibles

Una Offer usada como introductoria puede contener:

1. Una fase `free_trial` opcional al comienzo.
2. Como máximo una fase finita `percentage` o `amount_off`.

No puede usar `fixed_price`, varias fases de descuento ni un descuento sin vencimiento.

```typescript theme={null}
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.

## Elegibilidad

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.

## Selección al crear la suscripción

```typescript theme={null}
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`.

## Trials y campos de compatibilidad

`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.

## Relacionado

* [Offers](/docs/es/offers)
* [Promotional Offers](/docs/es/promotional-offers)
* [Promo Codes](/docs/es/promo-codes)
* [Períodos de prueba](/docs/es/trial-periods)
* [Administrar suscripciones](/docs/es/manage-subscriptions)


## Related topics

- [Offers](/docs/es/offers.md)
- [Promotional Offers](/docs/es/promotional-offers.md)
- [Offers, Promo Codes y Card Promotions](/docs/es/how-do-offers-promo-codes-and-card-promotions-work-together.md)
- [Promo Codes](/docs/es/promo-codes.md)
- [Descuentos](/docs/es/how-do-discounts-work.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.