# Configurar ofertas de prueba en las suscripciones Ofrece pruebas gratuitas o de pago para las partidas de una suscripción. ![](https://b.stripecdn.com/docs-statics-srv/assets/trial-offer.2128af954f90482fce40e29d1604a01b.png) Usa la API [Trial Offer](https://docs.stripe.com/api/product-catalog/trial-offer.md?api-version=2026-09-30.endive) para gestionar los períodos de introducción sin cargo y los pagos de tus [suscripciones](https://docs.stripe.com/subscriptions.md) con una sola integración API. Las ofertas de prueba te permiten calificar a clientes potenciales de alta intención, reducir el abuso de prueba y ofrecer tarifas con descuento a tus clientes por un período limitado (p. ej., 1 USD durante la primera semana de una oferta). ## Casos de uso Con las ofertas de prueba, puedes ejecutar experimentos de precios promocionales y ofertas de productos directamente en Stripe. Los casos de uso más comunes para las ofertas de prueba incluyen: | Caso de uso | Descripción | | --- | --- | | **Pruebas con descuento** | Para mejorar la conversión de prueba a pago y generar ingresos, puedes configurar pruebas con descuento. Por ejemplo, puedes ofrecer un precio introductorio reducido de 4 USD durante 4 semanas o una prueba gratuita de 7 días. | | **Pruebas gratuitas** | Para ofrecer una suscripción gratuita de prueba, incluye una partida en la suscripción. | | **Actualiza las pruebas** | Para ofrecer funcionalidades premium, puedes configurar pruebas de actualización. Por ejemplo, ofreces a un cliente con un plan básico una prueba de 7 días para acceder a funcionalidades premium a la tarifa básica. Luego, cuando finaliza la prueba, lo conviertes automáticamente en la tarifa premium. | | **Pruebas a nivel de partida** | Para vender complementos, paquetes de IA y otros paquetes de funcionalidades, puedes configurar pruebas a nivel de partida. Ofrece a los clientes una prueba solo para una partida de la suscripción, mientras facturas las demás partidas a su precio habitual. | ## Before you begin - Tu integración debe usar la versión [2026-09-30.endive](https://docs.stripe.com/changelog.md#2026-09-30.endive) o una posterior. Especifica esta [versión de Stripe](https://docs.stripe.com/api/versioning.md) en el encabezado de tu solicitud. - Para usar ofertas de prueba, debes crear nuevas suscripciones con el modo de facturación configurado en [flexible](https://docs.stripe.com/billing/subscriptions/billing-mode.md#create-a-new-subscription-with-flexible-billing-mode) o actualizar las suscripciones existentes que usan el modo de facturación `classic` para que usen `flexible` en su lugar. ### Limitaciones **Restricciones de integración** - Las ofertas de prueba se admiten cuando se crean o actualizan suscripciones en el Dashboard o con la API Subscriptions. Las siguientes integraciones de la interfaz de usuario (IU) no admiten las ofertas de prueba: - Integraciones de [Checkout Sessions](https://docs.stripe.com/payments/subscriptions.md) fuera de la [versión preliminar privada](https://docs.stripe.com/payments/checkout/trial-offers.md). Las cuentas invitadas pueden usar ofertas de prueba con Checkout alojado en Stripe con el modo de facturación flexible. - [Tablas de precios](https://docs.stripe.com/payments/checkout/pricing-table.md) - [Payment Links](https://docs.stripe.com/payment-links.md) - [Elements con Sessions de Checkout](https://docs.stripe.com/payments/elements.md) - No puedes usar las ofertas de prueba y el parámetro heredado `trial_end` juntos. Te recomendamos usar la API Trial Offer para configurar las pruebas con descuento y sin cargo. Para elegir entre una oferta de prueba y un período de prueba gratuita de suscripción, [compara los períodos de prueba gratuita y las ofertas de prueba](https://docs.stripe.com/billing/subscriptions/trials/compare.md). **Limitaciones del Dashboard** - Las ofertas de prueba con calendarios de suscripciones están en versión preliminar pública y no se admiten en el Dashboard. Usa la API para gestionarlas. - Puedes usar el portal de clientes para ver y cancelar ofertas de prueba. También puedes reactivar suscripciones con ofertas de prueba. No puedes actualizar, pausar ni reanudar suscripciones con ofertas de prueba. **Limitaciones de facturación y análisis** - Las ofertas de prueba solo se aplican a las partidas de suscripción recurrentes. Las partidas no recurrentes no son elegibles para pruebas pagas ni para tarifas de prueba con descuento. - No puedes modificar la duración de la prueba después de crear la suscripción ni programar extensiones y reducciones de prueba. - El precio posterior a la prueba debe ser diferente de cualquier precio que ya figure en la suscripción. - Stripe elimina la oferta de prueba de la suscripción después de que termina la prueba. - No hay una forma nativa de programar la eliminación de una única partida de la suscripción cuando termina su prueba. - In [Billing Analytics](https://docs.stripe.com/billing/subscriptions/analytics.md), trial offer items don’t contribute to MRR while they’re in a trial period. Other items on the same subscription continue to contribute to MRR. ## Cómo funcionan las ofertas de prueba Una suscripción le cobra a un cliente por un producto, al precio especificado, de forma recurrente. Cuando creas una oferta de prueba, especificas un precio de prueba y una duración de la prueba para un producto. Cuando finaliza la prueba, la suscripción pasa automáticamente al precio normal o a otro precio que configures. > Necesitas dos objetos Price recurrentes separados para crear una oferta de prueba: uno para el período de prueba y otro para el período posterior a la prueba. Las ofertas de prueba no reemplazan a los [productos o precios](https://docs.stripe.com/products-prices/how-products-and-prices-work.md). `Trial Offer` es un objeto separado que adjunta un precio con descuento o sin cargo a una [Partida de la suscripción](https://docs.stripe.com/api/subscription_items.md) por un tiempo limitado. El [precio](https://docs.stripe.com/api/subscription_items/object.md?#subscription_item_object-price) de la partida es el precio de prueba mientras la prueba está activa y el precio de transición después de que termina. ## Crear una oferta de prueba #### Dashboard Para crear una oferta de prueba en el Dashboard, debes hacer lo siguiente: 1. Ve a la página [Productos](https://dashboard.stripe.com/products). 2. Haz clic en un producto para abrir la página de detalles del producto. 3. En la sección **Pruebas**, haz clic en el símbolo más (+). 4. Completa el cuadro de diálogo **Crear prueba** con el precio, la duración y el comportamiento de finalización de la prueba. 5. Haz clic en **Crear**. También puedes crear una oferta de prueba desde el editor de suscripciones: 1. Ve a la página [Suscripciones](https://dashboard.stripe.com/subscriptions). 2. Haz clic en **+ Crear suscripción** o haz clic en una suscripción existente y selecciona **Acciones** > **Actualizar suscripción**. 3. Haz clic en **Agregar prueba**. 4. En el cuadro de diálogo, selecciona **+ Prueba** para crear una nueva oferta de prueba. 5. Agrega los detalles de la prueba, incluidos el precio, la duración y el comportamiento de finalización de la prueba. 6. Haz clic en **Crear**. #### API Para [crear una oferta de prueba](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive), pasa un [precio](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive#create_product_catalog_trial_offer-price) con el [price.id](https://docs.stripe.com/api/prices/object.md#price_object-id) a fin de definir el costo durante el período de prueba. Puedes establecerlo en 0 USD para pruebas sin cargo o cualquier monto positivo para pruebas pagadas. Establece el [duration.type](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive#create_product_catalog_trial_offer-duration-type) de la prueba en `relative` y usa [duration.relative.iterations](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive#create_product_catalog_trial_offer-duration-relative-iterations) para definir el número de intervalos de facturación. Luego, usa [end_behavior.transition.price](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive#create_product_catalog_trial_offer-end_behavior-transition-price) para especificar el precio que usa la suscripción cuando termina la prueba. Opcionalmente, establece un `nickname` a fin de agregar una etiqueta interna para la oferta de prueba. ### Crear una oferta de prueba con una duración relativa ```curl curl https://api.stripe.com/v1/product_catalog/trial_offers \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d price=price_trial \ -d "duration[relative][iterations]=1" \ -d "duration[type]=relative" \ -d "end_behavior[transition][price]=price_regular" ``` ### Crear una oferta de prueba con una duración de marca de tiempo > Las duraciones de las ofertas de prueba con marca de tiempo están en [versión preliminar pública](https://docs.stripe.com/release-phases.md). Las funcionalidades podrían cambiar durante el desarrollo. ```curl curl https://api.stripe.com/v1/product_catalog/trial_offers \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d price=price_trial \ -d "duration[type]=timestamp" \ -d "end_behavior[transition][price]=price_regular" ``` Para archivar una oferta de prueba y evitar que se use en suscripciones nuevas, [establece `active` en `false`](https://docs.stripe.com/api/product-catalog/trial-offer/update.md?api-version=2026-09-30.endive). Establécelo en `true` para desarchivarlo. ## Adjuntar una oferta de prueba a una suscripción nueva #### Dashboard Para asociar una oferta de prueba a una nueva suscripción en el Dashboard, debes hacer lo siguiente: 1. Ve a la página [Suscripciones](https://dashboard.stripe.com/subscriptions). 2. Haz clic en **+ Crear suscripción**. 3. Haz clic en **Agregar prueba**. 4. En el cuadro de diálogo, selecciona una oferta de prueba existente o selecciona **Nueva prueba** para crear una nueva oferta de prueba y agregarla a la suscripción. #### API Para adjuntar la oferta de prueba a una [suscripción](https://docs.stripe.com/api/subscriptions/object.md), especifica el [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-09-30.endive#product_catalog_trial_offer_object-id) en el parámetro [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial): #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "billing_mode[type]=flexible" \ -d "items[0][current_trial][trial_offer]=to_123" \ -d "items[0][quantity]=1" ``` #### Cliente v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer={{CUSTOMER_ID}}" \ -d "billing_mode[type]=flexible" \ -d "items[0][current_trial][trial_offer]=to_123" \ -d "items[0][quantity]=1" ``` ## Actualizar las suscripciones con una oferta de prueba ### Agregar una oferta de prueba a una suscripción existente #### Dashboard Para agregar una oferta de prueba a una suscripción existente en el Dashboard, debes hacer lo siguiente: 1. Ve a la página [Suscripciones](https://dashboard.stripe.com/subscriptions). 2. Haz clic en la suscripción para la actualización y luego selecciona **Acciones** > **Actualizar suscripción**. 3. Haz clic en **Agregar prueba**. 4. En el cuadro de diálogo, selecciona una oferta de prueba existente o selecciona **+ Prueba** para crear una nueva oferta de prueba y agregarla a la suscripción. #### API Para adjuntar la oferta de prueba a una suscripción existente, especifica el [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-09-30.endive#product_catalog_trial_offer_object-id) en el parámetro [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial): ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "items[0][current_trial][trial_offer]=to_123" ``` ### Agregar una oferta de prueba a una suscripción con partidas existentes #### Dashboard Para agregar una oferta de prueba como otra partida a una suscripción que tiene partidas existentes en el Dashboard, debes hacer lo siguiente: 1. Ve a la página [Suscripciones](https://dashboard.stripe.com/subscriptions). 2. Haz clic en la suscripción para la actualización y luego selecciona **Acciones** > **Actualizar suscripción**. 3. Haz clic en **Agregar prueba**. 4. En el cuadro de diálogo, selecciona una oferta de prueba existente o selecciona **+ Prueba** para crear una nueva oferta de prueba y agregarla a la suscripción. #### API Para agregar una oferta de prueba como otra partida a una suscripción que tiene partidas existentes, agrega una partida a la matriz [items](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items) y especifica [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-09-30.endive#product_catalog_trial_offer_object-id) en el parámetro [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial): ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "items[0][id]={{SUBSCRIPTIONITEM_ID}}" \ -d "items[1][current_trial][trial_offer]=to_123" \ -d "items[1][quantity]=1" ``` ### Convertir una partida de suscripción en una oferta de prueba Para convertir una partida existente de una suscripción en una oferta de prueba, incluye [items.id](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-id) y especifica [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-09-30.endive#product_catalog_trial_offer_object-id) en el parámetro [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial): ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "items[0][id]={{SUBSCRIPTIONITEM_ID}}" \ -d "items[0][current_trial][trial_offer]=to_123" ``` ### Cambiar la cantidad de partidas para una oferta de prueba #### Dashboard Para cambiar la cantidad de la partida de una oferta de prueba en el Dashboard, debes hacer lo siguiente: 1. Ve a la página [Suscripciones](https://dashboard.stripe.com/subscriptions). 2. Haz clic en la suscripción para la actualización y luego selecciona **Acciones** > **Actualizar suscripción**. 3. Edita el campo de cantidad después de agregar la partida de la oferta de prueba. 4. Haz clic en **Actualizar suscripción**. #### API Para cambiar la [cantidad](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-quantity) de la partida de una oferta de prueba, actualiza la suscripción: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "items[0][id]={{SUBSCRIPTIONITEM_ID}}" \ -d "items[0][quantity]=2" ``` ## Agregar una oferta de prueba a un calendario de suscripciones > Las ofertas de prueba con calendarios de suscripciones están en [versión preliminar pública](https://docs.stripe.com/release-phases.md). Las funcionalidades podrían cambiar durante el desarrollo. Solo puedes usar ofertas de prueba con marca de tiempo con [calendarios de suscripciones](https://docs.stripe.com/api/subscription_schedules.md?api-version=2026-03-25.preview). A diferencia de las pruebas de duración relativa, que finalizan después de una cantidad fija de intervalos de facturación, las pruebas con marca de tiempo finalizan en una fecha absoluta. Para crear una, establece [duration.type](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-duration-type) de la oferta de prueba en `timestamp`: ```curl curl https://api.stripe.com/v1/product_catalog/trial_offers \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d price=price_trial \ -d "duration[type]=timestamp" \ -d "end_behavior[transition][price]=price_regular" ``` A continuación, usa [phases.items.trial_offer](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2026-03-25.preview#create_subscription_schedule-phases-items-trial_offer) para adjuntar la oferta de prueba a la [phase](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2026-03-25.preview#create_subscription_schedule-phases) de calendario del suscripciones: #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscription_schedules \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d start_date=1610403705 \ -d "phases[0][items][0][trial_offer]=to_123" \ -d "phases[0][end_date]=1610403706" ``` #### Cliente v1 ```curl curl https://api.stripe.com/v1/subscription_schedules \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "customer={{CUSTOMER_ID}}" \ -d start_date=1610403705 \ -d "phases[0][items][0][trial_offer]=to_123" \ -d "phases[0][end_date]=1610403706" ``` ## Ver suscripciones con ofertas de prueba Cuando [recuperas una suscripción](https://docs.stripe.com/api/subscriptions/retrieve.md), la respuesta incluye la configuración de cada partida, incluidas las ofertas de prueba: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" ``` ## Cancela una suscripción al final de una prueba paga Para cancelar la suscripción cuando finalice la prueba paga, debes hacer lo siguiente: 1. Crea una suscripción con una oferta de prueba. 2. Establece la fecha de cancelación al final del período de prueba. Este flujo admite renovaciones con aceptación explícita, por lo que los clientes no pasan automáticamente a una suscripción recurrente por defecto. #### Dashboard Para cancelar una suscripción al final de una prueba paga en el Dashboard, debes hacer lo siguiente: 1. En la página [Suscripciones](https://dashboard.stripe.com/subscriptions), busca la suscripción correspondiente, haz clic en el menú de contenido adicional (⋯) y selecciona **Cancelar suscripción**. 2. Selecciona **En un día personalizado** y establece la fecha para finalizar la prueba y la suscripción. 3. Haz clic en **Cancelar suscripción**. Para obtener más información, consulta [Cancelar suscripciones](https://docs.stripe.com/billing/subscriptions/cancel.md#canceling). #### API Para cancelar una suscripción al final de una prueba paga, establece el parámetro [cancel_at](https://docs.stripe.com/api/subscriptions/update.md?#update_subscription-cancel_at) al final del período de prueba: #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "items[0][current_trial][trial_offer]=to_123" \ -d "items[0][quantity]=1" \ -d cancel_at=1610403706 ``` #### Cliente v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][current_trial][trial_offer]=to_123" \ -d "items[0][quantity]=1" \ -d cancel_at=1610403706 ``` ## Usar ofertas de prueba con otras funcionalidades ### Ofertas de prueba con cobro por consumo Al crear un objeto [Price](https://docs.stripe.com/api/prices/object.md), puedes especificar un precio medido en lugar de un precio recurrente y adjuntarlo a una oferta de prueba. Esto te permite ofrecer las mismas funcionalidades del [modelo de cobro por consumo](https://docs.stripe.com/billing/subscriptions/usage-based.md) a un precio con descuento. Para utilizar un precio por uso, establece el [usage_type](https://docs.stripe.com/api/prices/object.md?#price_object-recurring-usage_type) en `metered` y agrega un [meter](https://docs.stripe.com/api/prices/object.md?#price_object-recurring-meter) existente para llevar un registro del consumo. ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d currency=usd \ -d billing_scheme=per_unit \ -d unit_amount=1 \ -d "recurring[interval]=week" \ -d "recurring[usage_type]=metered" \ -d "recurring[meter]=mtr_123" \ -d "product_data[name]=Trial Period Price" ``` A continuación, adjunta el precio a una oferta de prueba como lo harías con cualquier otro precio recurrente: ```curl curl https://api.stripe.com/v1/product_catalog/trial_offers \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d price=price_trial \ -d "duration[relative][iterations]=1" \ -d "duration[type]=relative" \ -d "end_behavior[transition][price]=price_regular" ``` ## Consideraciones adicionales ### Estado y oferta de prueba de suscripción Cuando se usan ofertas de prueba, el `status` de una suscripción está determinado por el precio de la prueba: - **Pruebas gratuitas ()**: si una suscripción solo contiene ofertas de prueba y todos los precios de las ofertas de prueba se establecen en , el estado de la suscripción es `trialing`. Esto coincide con el comportamiento heredado de `trial_end` y es ideal para flujos de prueba gratuitos estándar o sin tarjeta. - **Pruebas pagas (>)**: si la suscripción tiene una partida regular o las ofertas de prueba tienen un precio distinto de cero, el estado de la suscripción estará `active`, `incomplete` o `past_due`. Este comportamiento imita a otras suscripciones sin ofertas de prueba. Debido a que, para una prueba paga, es necesario un pago exitoso inmediato para comenzar, la suscripción sigue el ciclo de vida estándar `PaymentIntent`. Esto garantiza que tu lógica de facturación actual, como los webhooks para pagos exitosos, siga siendo consistente, ya sea que el cliente esté pagando un precio promocional o el importe recurrente completo. ### Eventos Cada vez que cambia una prueba, activa [Events](https://docs.stripe.com/api.md#event_types). Asegúrate de que tu integración los gestione. Por ejemplo, es posible que desees enviar un correo electrónico a un cliente antes de que finalice una prueba. Obtén más información sobre cómo [gestionar eventos de suscripción](https://docs.stripe.com/billing/subscriptions/webhooks.md#events). La siguiente tabla describe los eventos que se activan antes de que finalice una prueba, cuando una suscripción de prueba se pausa o cancela, y cuando se reanuda una suscripción y esta pasa a ser activa. | Evento | Descripción | Caso de uso | | --- | --- | --- | | `customer.subscription.deleted` | Se envía cuando finaliza una suscripción. | En respuesta a este evento, deja de proporcionar acceso a tu producto. La suscripción pasa al estado `canceled` y envía este evento después de que finaliza un período sin que haya un método de pago definido, si el comportamiento final `missing_payment_method` de la suscripción se establece en `cancel`. | | `customer.subscription.resumed` | Se envía cuando una suscripción ya no está en pausa. Cuando recibas este evento, otorga al cliente acceso al producto si se revocó el acceso cuando la suscripción estaba en pausa. | Las suscripciones suspendidas se convierten en suscripciones activas cuando se reanudan. La reanudación de una suscripción puede generar una factura y el Payment Intent correspondiente que deben pagarse antes de que la suscripción pase del estado `paused`. | | `customer.subscription.paused` | Enviado cuando una suscripción está en pausa. La facturación no se producirá hasta que se reactive la suscripción. Cuando recibas este evento, puedes revocar el acceso del cliente al producto hasta que agregue un método de pago y se reactive la suscripción. | En respuesta a este evento, deja de proporcionar acceso a tu producto. La suscripción pasa al estado `paused` y envía este evento después de que finaliza un período de prueba sin que haya un método de pago definido y si el comportamiento final `missing_payment_method` de la suscripción se establece en `pause`. El estado de la suscripción permanece en `paused` hasta que se reanude de forma explícita. | | `customer.subscription.updated` | Se envía cuando una suscripción o sus partidas cambian, incluso cuando una oferta de prueba cambia a su precio posterior a la prueba. | Actualiza tu acceso y el estado de facturación en función de los cambios en las partidas de la suscripción. | | `customer.subscription.trial_will_end` | Se envía de acuerdo con la configuración **Eventos de finalización de prueba** en el Dashboard, que de forma predeterminada es 3 días antes de que termine la prueba. Si la prueba es más corta que el intervalo configurado, se activa de inmediato. | Usa este evento para enviar tu propio correo electrónico de recordatorio. Los correos electrónicos de recordatorio alojados en Stripe se envían 7 días antes de que termine la prueba. Para obtener más información, consulta [Cómo gestionar los requisitos de cumplimiento de la normativa para pruebas y promociones](https://docs.stripe.com/billing/subscriptions/trials/manage-trial-compliance.md). | ### Comportamiento del anclaje del ciclo de facturación Agregar una oferta de prueba a una suscripción existente no restablece el [anclaje del ciclo de facturación](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-trial_settings) de la suscripción. Durante la duración de la prueba, el ciclo de facturación de la partida de la oferta de prueba se ancla de forma implícita a `trial_start`. Por ejemplo, una prueba de dos meses que comienza el 28 de febrero termina el 28 de abril, no el 30 de abril. Una prueba de dos meses que comienza el 31 de enero termina el 31 de marzo. Cuando la oferta de prueba termina y cambia al precio recurrente habitual, puedes configurar si el anclaje del ciclo de facturación de la suscripción se restablece con `trial_settings.end_behavior.billing_cycle_anchor`: - `now` (predeterminado): restablece el `billing_cycle_anchor` de la suscripción al momento exacto en que se completa la oferta de prueba. Esto crea un nuevo ciclo de facturación para el precio normal y genera una factura de importe total sin prorrateo. - `unchanged`: mantiene la delimitación original desde la primera vez que se creó la suscripción. El período comprendido entre la finalización de la prueba y la siguiente fecha de delimitación natural se factura como un importe prorrateado. Por ejemplo, si ofreces una prueba de 7 días por y quieres que el primer cargo mensual cubra un mes completo a partir del día 8: 1. 1 de enero: suscripción creada con una oferta de prueba de 7 días. 2. 8 de enero: finaliza la prueba. El `billing_cycle_anchor` se restablece automáticamente al 8 de enero. 3. Factura: Stripe genera una factura por el precio recurrente total de para el período del 8 de enero al 8 de febrero. No se aplica prorrateo. #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "items[0][current_trial][trial_offer]={{TRIAL_OFFER_ID}}" \ -d "trial_settings[end_behavior][billing_cycle_anchor]=unchanged" ``` #### Cliente v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][current_trial][trial_offer]={{TRIAL_OFFER_ID}}" \ -d "trial_settings[end_behavior][billing_cycle_anchor]=unchanged" ``` ### Comportamiento de método de pago faltante Cuando termina una oferta de prueba, puedes configurar cómo actúa Stripe si el cliente no tiene un método de pago asociado usando `trial_settings.end_behavior.missing_payment_method`. Stripe aplica este comportamiento al final de cada oferta de prueba. Las opciones son las siguientes: - `create_invoice` (predeterminado): cea una factura. Si la factura no se puede pagar, la suscripción pasa a `past_due`. - `cancel`: cancela la suscripción. - `pause`: pausa la suscripción hasta que la reanudes. Las ofertas de prueba tienen las mismas limitaciones que las pruebas sin cargo heredadas sin método de pago, incluida la limitación de que no se admiten partidas medidas. Para ver ejemplos de configuración y detalles adicionales, consulta [Cómo crear pruebas sin cargo sin recopilar un método de pago](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#create-free-trials-without-payment). > #### La facturación previa anula el comportamiento de finalización de la prueba > > La facturación previa anula `trial_settings.end_behavior.missing_payment_method` cuando se extiende más allá del final de una prueba, incluso si `missing_payment_method` está establecido en `pause` o `cancel`. La suscripción continúa con su ciclo de facturación normal después de que termina la prueba. Consulta [Facturación previa](https://docs.stripe.com/billing/subscriptions/prebilling.md) para obtener más información. ## See also - [Productos y precios](https://docs.stripe.com/products-prices/overview.md) - [Precios](https://docs.stripe.com/api.md#prices) - [Suscripciones](https://docs.stripe.com/api.md#subscriptions) - [Gestión de los períodos de facturación de suscripciones](https://docs.stripe.com/billing/subscriptions/billing-cycle.md)