Cómo usar períodos de prueba en suscripciones

Retrasa los pagos en las suscripciones activas que utilizan períodos de prueba.

Puedes iniciar la suscripción de un cliente con un período de prueba gratuito especificando un argumento trial_end al crear la suscripción:

El parámetro trial_end requiere una marca de tiempo que indique el momento exacto en el que termina la prueba. Al crear una suscripción, como alternativa, puedes usar el argumento trial_period_days, que debe ser un número entero que represente la cantidad de días que dura la prueba a partir de ese momento. El período de prueba debe ser de 730 días (2 años) o menos.

Al crear una suscripción con un período de prueba, el cliente no necesita especificar un método de pago. Aun así se crea inmediatamente una factura, pero por $0.

Cuando finaliza la prueba, si el status de la suscripción no está en estado paused, generamos una factura y enviamos una notificación de evento invoice.created. Aproximadamente una hora después, intentamos cobrar esa factura. Además, al finalizar la prueba, comienza un nuevo ciclo de facturación para el cliente.

Para poner fin a la prueba antes de tiempo, haz una llamada API para actualizar la suscripción especificando en trial_end una nueva marca de tiempo o ahora para que finalice de inmediato:

Cómo combinar pruebas con un delimitador del ciclo de facturación

A partir de la versión 2018-02-05 de API, también puedes combinar períodos de prueba con billing_cycle_anchor para obtener un período gratuito seguido de un período prorrateado y fijar un ciclo de cobros.

Por ejemplo, supongamos que es el día 15 del mes y quieres ofrecerle a un cliente una prueba gratuita de 7 días (hasta el 22) y después comenzar la facturación normal el primer día del siguiente mes. Esto es posible a través de la API combinando pruebas con billing_cycle_anchor. (Por el momento, no está disponible a través del Dashboard).

En este ejemplo, el cliente recibe una factura por un importe prorrateado el día 22 (para el período hasta el día 1 del mes). Luego, el día 1, se le facturará nuevamente el importe total, y a partir de entonces, se le facturará el importe total el primero de cada mes.

Facturación por uso en suscripciones suspendidas

Puedes enviar eventos del medidor asociados a un precio de una suscripción incluso cuando está en pausa. Sin embargo, después de que se reanude la suscripción, la factura no incluirá ningún evento del medidor enviado durante la pausa. Las facturas futuras solo incluyen eventos del medidor que ocurren después de la fecha de reanudación. Si utilizas registros de consumo heredados, no puedes crear nuevos registros de consumo mientras una suscripción esté en pausa.

Agregar una nueva prueba a una suscripción anterior en una versión de prueba

Puedes agregar una nueva prueba en una suscripción que no es de prueba actualizando la suscripción y especificando trial_end o actualizando el calendario de suscripciones asociado. Debes especificar phases.trial_end para las suscripciones.

Cuando una suscripción ingresa a una nueva prueba después de haber finalizado una prueba anterior, el campo trial_start permanece establecido en el inicio de la primera prueba. A partir de la versión de API 2025-04-30, trial_start refleja automáticamente el comienzo de la prueba recién agregada en las suscripciones con billing_mode establecido en credits_attributed_to_debits.

Cómo combinar pruebas con add_invoice_items

Los períodos de prueba de las suscripciones se pueden combinar con precios puntuales y con add_invoice_items. Esto puede darse si quieres cobrar una comisión por única vez o agregar un ítem al mismo tiempo que comienza la prueba. Ten en cuenta que, en este caso, se emitirá de inmediato una factura por el importe del ítem puntual al inicio de la prueba.

Requisitos de cumplimiento de pruebas y promociones

Si ofreces períodos de prueba, sean gratuitos o no, debes cumplir con los requisitos de las redes de tarjetas. Esto abarca diferentes escenarios, como períodos de prueba gratuitos o planes que contemplan el cobro de un precio reducido durante los primeros meses y después el cobro automático de la tarifa normal. Si usas nuestras funcionalidades de pruebas, puedes habilitar la configuración de mensajes en el Dashboard de Stripe para ayudarte a cumplir con los requisitos.

Si notificas a los usuarios cuando los pagos se efectúan con éxito, Stripe incluye en los mensajes información sobre la prueba y la URL de cancelación en forma automática.

Si no usas esta configuración, de todos modos sigues siendo responsable de cumplir con los requisitos.

Si se han habilitado los correos electrónicos para clientes, se envía un recordatorio siete días antes de la finalización de la prueba. Si la prueba dura menos de siete días, el correo recordatorio se envía en cuanto comienza la prueba. Si la prueba se renueva, se enviará otro correo recordatorio.

Si durante una prueba están habilitados los recordatorios tanto de la prueba como de la renovación de la suscripción, el cliente solo recibirá un recordatorio cuando la prueba esté por finalizar. Los correos de renovación se enviarán luego en los períodos de facturación sucesivos.

El enlace de la política de cancelaciones es una URL que aparece en los recibos de los clientes junto con otros datos de la prueba. Esta información se incluye en todos los pagos con tarjeta. La URL para cancelaciones también figura en el correo recordatorio que se envía a los clientes siete días antes de la finalización de la prueba.

Si configuras manualmente la descripción del cargo en el extracto bancario en la factura, no se agregará el texto de prueba, por lo que tendrás que agregarlo tú. Si usas descripciones de productos, el texto de prueba se agregará automáticamente. Si tu descripción excede los 10 caracteres, asegúrate de que siga siendo comprensible para los clientes con el texto de prueba agregado. Existe un límite de 22 caracteres, por lo que todo lo que aparezca después del décimo carácter se sobrescribirá con el texto * TRIAL OVER.

El texto de la prueba se adjunta a la descripción del cargo en el extracto bancario si no configuras la descripción manualmente o no usas descripciones de los productos. Si lo necesitas, puedes configurar una descripción abreviada para cerciorarte de que el texto de la prueba se vea correctamente.

Cómo cumplir los requisitos sin usar las funcionalidades de Stripe

Si ofreces períodos de prueba o promociones sin usar nuestras funcionalidades, de todos modos tendrás que cumplir con los requisitos. Puedes escuchar el evento invoice.upcoming para determinar cuándo enviar notificaciones por correo electrónico. Para agregar texto a la descripción del cargo en el extracto bancario que indique que la promoción ha terminado, haz lo siguiente:

Escucha el evento customer.subscription.updated
Verifica si ha finalizado una prueba o promoción
Actualiza la descripción del cargo para el extracto bancario en latest_invoice de la suscripción

Tienes que actualizar la última factura mientras aún esté en borrador dentro de la hora posterior a su creación.

Crea pruebas gratuitas sin tener que recopilar datos de pago

Consejo de seguridad

Si bien comenzar una prueba gratuita sin un método de pago permite que tus clientes potenciales prueben tu producto o servicio de manera más rápida, también puede permitir que los spammers creen muchos clientes, usos y suscripciones falsos. Recomendamos considerar cuidadosamente el flujo de registro de modo que sea fácil para los clientes reales y difícil para los robots de spam (por ejemplo, exigir a los clientes que creen una cuenta de usuario y completen un captcha antes de comenzar su suscripción de prueba gratuita).

Puedes registrar a los clientes para una prueba gratuita de una suscripción sin recopilar sus datos de pago en el Dashboard, la API y Checkout. Al crear la suscripción, puedes especificar si deseas cancelar o pausar la suscripción en caso de que el cliente no haya proporcionado un método de pago durante el período de prueba. Para cancelar o pausar la suscripción, establece el parámetrotrial_settings.end_behavior.missing_payment_method cuando la crees o la actualices:

Cancelar la suscripción: si la suscripción de prueba gratuita finaliza sin un método de pago, se cancela de inmediato. Puedes crear otra suscripción si el cliente decide suscribirse a un plan pago en el futuro. Establece missing_payment_method=cancel para cancelar la suscripción cuando finalice una prueba sin un método de pago disponible.
Pausa la suscripción: si la suscripción de prueba gratuita finaliza sin un método de pago, se pausa y no cambia hasta que se reanuda. Cuando una suscripción está en pausa, no genera facturas (a diferencia de cuando el cobro de una suscripción está en pausa). Cuando tu cliente agregue su método de pago después de que la suscripción se haya pausado, puedes reanudar la misma suscripción. La suscripción puede permanecer en pausa indefinidamente. Establece missing_payment_method=pause para pausar la suscripción cuando llegue al final de una prueba sin un método de pago disponible.

Como alternativa, establece missing_payment_method=create_invoice en la factura cuando finalice la prueba si no hay un método de pago disponible. Si no se proporciona un método de pago una vez finalizada la factura, la suscripción pasa a past_due.

Configura recordatorios por correo electrónico para recopilar los detalles de pago del cliente en tu configuración de mensajería de prueba gratuita.

Configura pruebas gratuitas sin métodos de pago para cancelar

Usa el Dashboard, la API o Checkout para crear pruebas gratuitas de una suscripción sin recopilar los datos de pago de tus clientes, y para configurar tu suscripción de manera que se cancele si el período de prueba finaliza y aún no hay un método de pago definido.

Para que los clientes creen una cuenta por una prueba gratis de una suscripción sin recopilar sus datos de pago, puedes usar el Dashboard:

En la configuración de suscripciones en el Dashboard, selecciona +Crear suscripción.
Después de agregar la información del producto y el cliente, haz click en +Agregar prueba gratuita e ingresa la cantidad de días que durará.
Selecciona la opción Pausar o cancelar si la prueba gratuita finaliza sin un método de pago y, a continuación, selecciona Cancelar de inmediato. Si estás usando clocks de prueba, avanza hasta el final de la prueba. No verás la próxima factura de la suscripción.
Escucha el evento customer.subscription.deleted que te indica cuándo una suscripción se cancelará una vez finalizados los períodos de pruebas que no tienen un método de pago definido.

Si proporcionas un método de pago o seleccionas la opción Enviar factura por correo electrónico al cliente con enlace a la página de pagos, la opción Pausar o cancelar si la prueba gratuita finaliza sin un método de pago no estará disponible.

Configura pruebas gratuitas sin métodos de pago para pausar

Usa el Dashboard, la API o Checkout para crear pruebas gratuitas de una suscripción sin recopilar los datos de pago de tus clientes, y para configurar tu suscripción de manera que se pause si el período de prueba finaliza y aún no hay un método de pago definido.

Para que los clientes creen una cuenta por una prueba gratis de una suscripción sin recopilar sus datos de pago, puedes usar el Dashboard:

En la configuración de suscripciones en el Dashboard, selecciona +Crear suscripción.
Después de agregar la información del producto y el cliente, haz click en +Agregar prueba gratuita e ingresa la cantidad de días que durará.
Selecciona la opción Pausar o cancelar si la prueba gratuita finaliza sin un método de pago y, a continuación, selecciona Pausar. Si estás usando clocks de prueba, avanza hasta el final de la prueba. No verás la próxima factura de la suscripción.
Escucha el evento customer.subscription.pausedque te indica cuándo una suscripción se pausará una vez finalizados los períodos de pruebas que no tienen un método de pago definido.

Recopila los datos de pago del cliente antes de que finalice la prueba

Configura tu suscripción para que envíe en forma automática un correo electrónico recordatorio cuando la versión de prueba del cliente esté a punto de caducar. Debes cumplir con los requisitos de la red de tarjetas cuando ofrezcas pruebas. Obtén más información sobre los requisitos de cumplimiento de las pruebas y promociones.

Eventos

Los eventos se activan cada vez que cambia una prueba gratuita. Asegúrate de que tu integración los gestione correctamente. Por ejemplo, es posible que quieras enviar un correo electrónico a un cliente antes de que finalice una prueba gratuita. Obtén más información sobre cómo gestionar eventos de suscripción.

La siguiente tabla describe los eventos que se activan antes de que finalice una prueba gratuita, 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 de prueba gratuita sin que haya un método de pago definido y si el comportamiento final `missing_payment_method` de la suscripción se establece en `cancel`.
`customer.subscription.resumed`	Enviado 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 pausadas pasan a ser suscripciones activas una vez que se reanudan. Es posible que la reanudación de la suscripción genere una factura y el Payment Intent correspondiente que debe pagarse antes de que la suscripción salga 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 gratuita 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 en forma explícita.
`customer.subscription.trial_will_end`	Enviado tres días antes de que finalice el período de prueba. Si el período de prueba es menor de tres días, el evento se activa.	Configura la suscripción para que se envíe automáticamente un correo electrónico a tu cliente tres días antes de que finalice el período de prueba.

Usa el portal de clientes para cobrar pagos

Después de crear una suscripción para un cliente sin recopilar un método de pago, puedes redirigirlo al portal de clientes de Billing para ingresar sus datos de pago.

En primer lugar, configura el portal de clientes de Billing para que tus clientes puedan gestionar sus suscripciones.

Luego, recopila los datos de facturación de tus clientes:

Escucha el evento customer.subscription.trial_will_end.
Si la suscripción no tiene un método de pago predeterminado, recupera el correo electrónico del cliente con la API Customers y envíale un mensaje con un enlace a tu sitio web. Es útil insertar la ID del cliente en el correo. Por ejemplo: https://example.com?...&customer={{CUSTOMER_ID}}.
Cuando el cliente ingrese a tu sitio, crea una sesión en el portal de clientes utilizando el ID de cliente del paso anterior.
Redirige al cliente al portal de clientes, donde puede actualizar su suscripción con los datos de pago.

Permite que los clientes reactiven sus suscripciones en el portal de clientes.

Para habilitar en el portal de clientes la suscripción de un cliente cuyo período de prueba finalizó y la suscripción está en estado paused, activa la funcionalidad de prueba gratuita sin método de pago al crear una suscripción nueva en el Dashboard.

Envía un correo electrónico de recordatorio antes de la finalización de la prueba

Para enviar un recordatorio por correo electrónico antes de que finalice la prueba, selecciona la opción Enlace a una página alojada en Stripe en la configuración de suscripciones y correos electrónicos. El correo electrónico de recordatorio contiene un enlace para que el cliente agregue o actualice sus datos de pago. No enviamos recordatorios por correo electrónico de pruebas gratuitas en el entorno de prueba. Obtén más información sobre cómo configurar recordatorios de pruebas gratuitas.

Usa el evento customer.subscription.trial_will_end para enviar tus propios correos electrónicos alojados a los clientes. Después de ver el evento en el Dashboard, se confirma que tu correo electrónico se envió correctamente.

Convierte una prueba si el cliente brinda información de pago antes de que finalice el período de prueba

Las suscripciones y facturas próximas se crean al principio de la prueba y se activan una vez que finaliza, si el cliente indica un método de pago.

Configura la suspensión de las suscripciones cuando no se indica un método de pago

Una vez finalizada la prueba gratuita, puedes configurar las suscripciones de forma que se suspendan si no existe un método de pago predeterminado para cada suscripción.

Puedes actualizar las suscripciones mientras estén pausadas. Las actualizaciones que suelen incurrir en prorrateos (agregar ítems, cambiar el precio o el plan, modificar la cantidad, etc.) no generarán ítems de factura de prorrateo porque no se le está cobrando al cliente mientras la suscripción está pausada. Si quieres extender el período de prueba después de que una suscripción pase al estado paused, debes reactivar la suscripción antes de configurar una prueba.

Revisamos default_source y default_payment_method tanto en la suscripción como en el cliente para determinar si falta una suscripción o un método de pago al finalizar una prueba.

Reactivar una suscripción suspendida

Utiliza el Dashboard, la API, el portal de clientes o la página de facturas alojadas para reanudar una suscripción pausada.

Para reactivar una suscripción en pausa en el Dashboard, dirígete a la suscripción y selecciona Reactivar suscripción en el menú Acciones. Selecciona **Restablecer el ciclo de facturación ** o Facturar siempre (si no estás restableciendo el ciclo de facturación) en el cuadro de diálogo Reactivar suscripción para cobrarle al cliente inmediatamente.

Cómo facturar una suscripción

Mientras una suscripción está suspendida, no se generan facturas. Si quieres seguir creando facturas, usa pause_collection para pausar el cobro de pagos; podrás seguir facturando y adelantando los períodos de facturación.

Para obtener una vista previa de la factura que se genera cuando se reanuda una suscripción pausada, especifica subscription_details.resume_at.