Brinda mayor flexibilidad para las suscripciones
Usa el modo de facturación flexible para obtener características mejoradas y acceder a más funcionalidades.
Flexible billing mode provides accurate and predictable billing behavior and additional features for managing subscriptions. Setting billing_ on a subscription changes how Subscription objects behave throughout their lifecycle and in response to upgrades, downgrades, and cancellations.
El modo de facturación flexible permite capacidades diferentes para la gestión de suscripciones en comparación con el modo de facturación clásico. Consulta Diferencias entre el modo de facturación clásico y flexible para obtener más información.
Para usar el modo de facturación flexible, tu integración debe estar en la versión de la API de Stripe 2025-06-30.basil o posterior. Aprende a actualizar tu versión de API. No es posible cambiar de modo de facturación flexible a modo clásico.
Limitaciones
El modo de facturación flexible no es compatible con todas las funciones de Stripe Billing. Las siguientes funciones son incompatibles y devuelven un código de estado 400 cuando creas y actualizas una suscripción con el modo de facturación flexible habilitado:
- Versiones de pruebas pagadas
- Modelo de cobro por consumo heredado
- Las integraciones del impuesto de terceros heredado que usan
pay_immediately=false - Facturación adelantada Vista previa privada
- Subscription-specific
retry_Vista previa privadasettings - El uso del parámetro
max_heredadooccurences
Configurar el modo de facturación
Crea una nueva suscripción con modo de facturación flexible
Migra tus suscripciones actuales al modo de facturación flexible
Puedes migrar tus suscripciones existentes al modo de facturación flexible. Los comportamientos flexibles entran en efecto para toda nueva actividad en la suscripción después de la migración. Sin embargo, Stripe no recalcula ningún recurso creado antes de la migración, incluidas las Partida de factura pendientes de prorrateo.
Diferencias entre el modo de facturación clásico y flexible
Cálculos de prorrateo de crédito
Se emiten prorrateos en forma de crédito cuando los clientes reducen el nivel de sus suscripciones o cancelan items de suscripción antes de que finalice el período de facturación. El modo de facturación flexible calcula estos prorrateos en función del importe original previamente debitado al cliente.
Para obtener un resumen completo de los cálculos de prorrateo de crédito, consulta Prorrateos de crédito.
| Clásica | Flexible |
|---|---|
| Cuando una actualización de una suscripción genera un prorrateo en forma de crédito, los importes de dicho prorrateo se calculan según el valor del precio establecido en el item de suscripción, los impuestos, la cantidad y los últimos descuentos aplicados. | Cuando una actualización de una suscripción genera un prorrateo en forma de crédito, dicho prorrateo se basa en el importe original debitado en lugar de los valores actuales de la suscripción. |
Aplicación de descuento proporcional para prorrateos
Aplicamos los descuentos de manera proporcional a cada item de suscripción durante los cálculos de prorrateo en lugar de distribuirlos de forma uniforme. Esto genera más prorrateos, especialmente al facturar por item o al cancelar items con descuentos distribuidos de manera desigual.
| Clásica | Flexible |
|---|---|
| Distribuimos los descuentos de manera uniforme entre todos los ítems de suscripciones. | Aplicamos descuentos proporcionalmente a cada ítem de suscripción durante los cálculos de prorrateo. |
Tarifas por consumo
Suprimir partidas de importe cero al agregar items basados en el consumo
El modo de facturación flexible no crea partidas con importe cero cuando se agregan items basados en el consumo a una suscripción. Si como resultado la factura queda vacía, no se genera ninguna.
Por ejemplo, al agregar un item mensual basado en el consumo durante la creación o actualización de una suscripción:
| Clásica | Flexible |
|---|---|
Se genera una partida en la factura por un importe de 0 USD para el item basado en el uso. Esto también aplica al actualizar una suscripción sin renovar el ciclo para agregar un item basado en el consumo cuando se usa proration_. | No se agrega una partida de 0 USD a la factura por el item basado en el consumo. Si la factura resultante no contiene ninguna partida, no se genera. |
Facturar los items basados en el consumo según el precio en el momento del reporte.
Los cargos del modo de facturación flexible por el consumo según el precio que estaba en vigor cuando se informó el consumo, en lugar del precio más reciente.
Por ejemplo, el consumo de un cliente se informa como:
- Consumo el 5 de enero: 1000 llamadas API a 0.1 USD por 100 llamadas (Precio A).
- Cambio de precio el 15 de enero: el precio cambia a por 100 llamadas (Precio B).
- Consumo el 20 de enero: 500 llamadas API.
| Clásica | Flexible |
|---|---|
Stripe solo factura el consumo que se informó desde el cambio al precio actual.
Importe total de la factura = 0.75 USD. | Stripe factura todo consumo del período actual al precio vigente en el momento en que se informa.
Importe total de la factura = 1.75 USD. |
Facturar el uso no facturado al eliminar items basados en el consumo
El modo de facturación flexible genera una partida de factura por el uso no facturado al eliminar un item de suscripción establecido en el consumo. Esto se aplica tanto a eliminaciones mediante la API como durante las transiciones de fase en el calendario.
| Clásica | Flexible |
|---|---|
| No se genera ninguna partida de factura por el uso no facturado al eliminar un item de suscripción establecido en el consumo. | Se genera una partida de factura por el uso no facturado al eliminar un item de suscripción establecido en el consumo. |
Restablecer la delimitación del ciclo de facturación
El modo de facturación flexible solo restablece la delimitación del ciclo de facturación en las actualizaciones de las suscripciones cuando estableces billing_ explícitamente en un valor distinto de unchanged.
| Clásica | Flexible |
|---|---|
El billing_ se restablece automáticamente a la fecha actual cuando se cambia una suscripción a un precio diferente con un intervalo recurrente diferente, de precios de importe cero a precio distinto de cero o se mueve cancel_at a una fecha anterior a la próxima vez que se realice la suscripción. | El billing_ nunca se restablece automáticamente. |
Facturación consolidada para las transiciones de fase en el calendario de suscripciones con items basados en el consumo.
El modo de facturación flexible genera de manera constante una sola factura cuando una suscripción se renueva. Este cambio elimina facturas separadas para los items basados en el consumo que se hayan eliminado y mejora la consistencia en la facturación.
Cuando tu suscripción con items basados en el consumo pasa de una fase a otra:
| Clásica | Flexible |
|---|---|
| Se generan dos facturas. | Se genera una única factura consolidada. Esta factura incluye tanto items establecidos en el consumo como items con licencia, aplica los descuentos de la fase anterior al modelo de cobro por consumo y utiliza las tasas impositivas de la siguiente fase. |
Cancelación de suscripción programada
You can disable prorations for a truncated first subscription period (when setting cancel_ on creation) using the proration_ parameter.
| Clásica | Flexible |
|---|---|
| Los prorrateos se aplican al primer período de suscripción. | Los prorrateos no se aplican al primer período de suscripción. |
Suscripciones con fechas pasadas
When backdating is consistent with regular billing, flexible billing mode creates separate invoice line items for each billing period within the backdated range. It also automatically aligns the billing cycle anchor to the backdate_ when not explicitly set. Backdating isn’t supported if the resulting invoice has more than 250 line items.
Por ejemplo, una suscripción debe antedatarse debido a la falta de una factura de los últimos dos ciclos de facturación. Al cliente se le facturaron 2 períodos antedatados diferentes:
- Período de facturación 1 (del 1 al 31 de marzo):
- Consumo informado: Se usaron 100 GB de almacenamiento.
- Precio: 10 USD por 10 GB.
Período de facturación 2 (del 1 al 30 de abril):
- Consumo informado: Se utilizan 150 GB de almacenamiento.
- Precio: 10 USD por 10 GB.
El proveedor de servicios decide antedatar la factura para cubrir ambos períodos de facturación: del 1 de marzo al 30 de abril.
| Clásica | Flexible |
|---|---|
Los cargos de todo el período antedatado se calculan de manera conjunta como una sola partida. Cargos totales:
| Los intervalos de tiempo antedatados se dividen en varias partidas de factura de acuerdo con los límites del período de suscripción. Cargos totales:
|
Versiones de prueba
Actualiza la fecha de inicio de la prueba para las pruebas posteriores
El modo de facturación flexible utiliza la fecha de inicio de prueba más reciente para las suscripciones con pruebas posteriores.
Por ejemplo, cuando tienes:
- Período de prueba del 1 de enero al 1 de febrero
- Período normal de facturación del 1 de febrero al 1 de marzo
- Período de prueba del 1 de marzo al 1 de abril
| Clásica | Flexible |
|---|---|
El subscription. siempre se refiere a la primera prueba que comenzó una suscripción. | El subscription. se refiere al inicio de la prueba más reciente de una suscripción. |
Conservar la fecha de finalización de la prueba original cuando se cancela la suscripción
El modo de facturación flexible conserva el trial_ si modificas la fecha cancel_.
| Clásica | Flexible |
|---|---|
Si la fecha de trial_ es posterior a cancel_, trial_ se establece en la fecha de cancelación. Si cancel_ se actualiza o elimina más adelante, trial_ no se establece en su valor original. | Programar la cancelación de una suscripción con cancel_ ya no altera la fecha trial_. Esto garantiza que las pruebas se ejecuten durante la el periodo previsto, independientemente de las actualizaciones de la fecha de cancelación. |
Estandariza la descripción de la partida del período de prueba
El modo de facturación flexible utiliza un formato de descripción coherente para los items establecidos en el consumo y con licencia durante los períodos de prueba.
Por ejemplo, cuando tiene un suscripción a café mensual (con licencia) y un suscripción alpaca_ (establecida en el consumo), la descripción de la suscripción se muestra de la siguiente manera:
| Clásica | Flexible |
|---|---|
Licensed items use the template
| El mismo formato,
|
Volver a facturar las partidas correspondientes al período de prueba
El modo de facturación flexible solo genera partidas por los cambios realizados durante una prueba. Las partidas existentes sin cambios no se vuelven a facturar.
Por ejemplo, cuando haces una actualización para agregar otro elemento de prueba price_ a una suscripción en período de prueba con price_:
| Clásica | Flexible |
|---|---|
| Los cambios realizados durante una prueba dan lugar a que no se genere ninguna factura o a una factura que reformule todo el estado de la suscripción. | Los cambios realizados durante una prueba siempre dan como resultado partidas de factura comparables a los cambios realizados fuera de la prueba. Por ejemplo, si se agrega un nuevo precio a una suscripción, también se agrega una partida de factura que represente esa adición. |
Items de factura pendientes
Incluir de manera coherente las partidas de factura pendientes
El modo de facturación flexible incluye todas las partidas de factura pendientes disponibles en las facturas generadas por un restablecimiento de delimitación del ciclo de facturación, donde proration_.
| Clásica | Flexible |
|---|---|
Las facturas con restablecimiento de la delimitación del ciclo de facturación incluyen partidas pendientes, mientras que las facturas always_ no. | Las partidas de factura pendientes siempre se incluyen en todas las facturas que genera una suscripción. |
Intervalos mixtos en la misma suscripción Vista previa privada
El modo de facturación flexible te da acceso a suscripciones de intervalos mixtos. Puedes facturar varios precios recurrentes con diferentes intervalos en una sola suscripción utilizando las suscripciones de intervalos mixtos. Esto te permite combinar diferentes estructuras de precios en una sola suscripción.
| Clásica | Flexible |
|---|---|
| No aceptado. Todos los ítems de una suscripción deben tener precios con el mismo intervalo y recuento de intervalos. | Crea suscripciones a intervalos mixtos en las que los ítems de una suscripción puedan tener precios recurrentes con diferentes intervalos o recuentos de intervalos. Por ejemplo, un precio mensual y un precio anual pueden existir en la misma suscripción. |