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

# Períodos de prueba

> Usa fases de prueba gratuita en Offers para onboarding automático o campañas explícitas.

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:

| Canal | Comportamiento del trial |
| - | - |
| Ubicación introductoria | Se aplica automáticamente a una nueva suscripción elegible |
| `offerId` directo | Tu aplicación lo selecciona explícitamente |
| Promo Code | El customer ingresa un código cuya Offer empieza con un trial y sigue con un descuento |
| `customTrialDays` | Crea condiciones específicas del customer sin una Offer reutilizable de catálogo |
| `skipTrial: true` | Omite el trial automático |

El trial de un Promo Code requiere al menos una fase de descuento posterior. El código se puede aplicar al crear la suscripción o ingresar en un checkout de pago pendiente, que pasa a un checkout de setup para el trial.

## Trial reutilizable

Creá una Offer y reutilizala:

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

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

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

```typescript theme={null}
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](/docs/es/offers)
* [Introductory Offers](/docs/es/introductory-offers)
* [Promotional Offers](/docs/es/promotional-offers)
* [Cómo funcionan los trials](/docs/es/how-do-trial-periods-work)
* [Manejar pagos fallidos](/docs/es/handle-failed-payments)


## Related topics

- [Cómo funcionan los cobros y pagos](/docs/es/how-does-billing-work.md)
- [Pagos fallidos](/docs/es/what-happens-when-a-payment-fails.md)
- [Offers](/docs/es/offers.md)
- [Trials](/docs/es/how-do-trial-periods-work.md)
- [Planes gratuitos](/docs/es/how-do-free-plans-work-without-payment.md)


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