Brinda mayor flexibilidad para las suscripciones

Puedes configurar tu modo facturación preferido para organizar tus facturas y suscripciones según las necesidades de tu empresa. Cada suscripción la puedes configurar para que use uno de estos dos modos de facturación:

• Flexible Recommended: esta configuración te da un comportamiento de facturación preciso y predecible, además de desbloquear nuevas funcionalidades. Para acceder a estas mejoras, que solo están disponibles en el modo de facturación flexible, debes crear suscripciones nuevas con este modo o migrar las que ya tienes.
• Clásico: utiliza el comportamiento de suscripciones Stripe existente. Esta configuración se mantiene para ser compatible con integraciones anteriores.

Puedes obtener más información sobre las diferencias detalladas entre el modo de facturación clásico y flexible y cómo elegir el modo de facturación que mejor se adapte a tus necesidades.

¿Por qué el modo de facturación flexible?

El modo de facturación flexible te brinda una facturación más precisa para prorrateos, precios establecidos en el consumo, facturación flexible y configuraciones de prueba. También desbloquea nuevas funcionalidades, como intervalos mixtos en la misma suscripción. Estas mejoras solo están disponibles en el modo de facturación flexible, por eso te recomendamos crear nuevas suscripciones con este modo y migrar las que ya tienes.

Recomendamos que los usuarios nuevos de Facturación usen el modo de facturación flexible para suscripciones y facturas, aunque no es obligatorio.

Para los usuarios actuales, tu modo de facturación predeterminado se mantiene como clásico para seguir siendo compatible con tu integración actual. Sin embargo, te recomendamos pasarte al modo de facturación flexible para aprovechar las últimas funcionalidades y mejoras de facturación. Obtén más información sobre las diferencias entre el modo facturación clásico y flexible.

Empezar con el modo de facturación flexible

Puedes configurar o actualizar el modo de facturación a través de la API o el Dashboard cuando creas o migras suscripciones. Si no especificas uno, se aplica un modo de facturación predeterminado.

• Si creas o actualizas una suscripción a través de la API, el valor predeterminado para el modo de facturación depende de la versión de tu integración de API.
• Si creas o actualizas suscripciones a través del Dashboard (incluidos Payment Links y Tablas de Precios), el valor predeterminado depende de la configuración por defecto del modo de facturación que configures en Configuración > **Facturación ** > Suscripciones y correos electrónicos.

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. Obtén información sobre cómo actualizar la versión de la API.

Crea una nueva suscripción con modo de facturación flexible

Dashboard

API

Puedes crear una suscripción en modo de facturación flexible o actualizar una clásica a flexible desde el Dashboard, sin importar la versión de API que use tu integración. Para modificar completamente estas suscripciones con la API de Stripe, tu integración tiene que estar en la versión 2025-06-30.basil o una posterior. Para ver qué versión tienes, ve a Resumen de Workbench y busca la sección de versiones de API. Desde allí, haz clic en Actualizar para actualizar a una versión más reciente.

Sigue estos pasos para crear una suscripción en modo de facturación flexible usando el editor de suscripciones:

1. Ve a la página Suscripciones en el Dashboard.
2. Selecciona +Crear suscripción.
3. Desplázate hacia abajo hasta la sección Configuración avanzada.
4. Establece el Modo de facturación en Flexible.

El valor predeterminado del modo de facturación depende de la configuración de tu cuenta. Puedes personalizar las opciones de modo de facturación que se muestran y la selección predeterminada en Configuración Avanzada configurando el ajuste predeterminado del modo de facturación en Configuración > Facturación > Suscripciones y correos electrónicos. En el editor de suscripciones, puedes elegir mostrar las opciones de modo de facturación de entre las siguientes:

• Clásico: se muestran los modos de facturación tanto flexible como clásico, con el clásico seleccionado de forma predeterminada. Esta opción se recomienda si tu integración depende del modo facturación clásico y aún no puedes migrar a facturación flexible.
• Flexible: se muestran los modos de facturación flexible y clásico, con el flexible seleccionado por defecto. Esta opción te la recomendamos si estás migrando activamente al modo de facturación flexible.
• Flexible y ocultar clásico: solo se muestra el modo de facturación flexible en el editor de suscripciones. Esta opción se recomienda para usuarios nuevos de Stripe Billing y para los usuarios actuales que usan exclusivamente el modo de facturación flexible.

Configuración del modo de facturación del Dashboard

La configuración predeterminada del modo de facturación también decide el modo de facturación para las suscripciones creadas a través de los Payment Links y las Tablas de Precios generados desde el Dashboard. Por ejemplo, si configuras el modo de facturación predeterminado como flexible y luego creas un Enlace de Pago en el Dashboard, cualquier suscripción que se genere a partir de ese Enlace de Pago usará el modo de facturación flexible.

La configuración predeterminada del modo de facturación solo aplica a las suscripciones nuevas que crees en el Dashboard. No afecta a las suscripciones creadas usando la API ni a las que migraste a modo 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.

Modo de facturación y calendarios de suscripciones

Cuando creas un calendario de suscripciones a partir de una suscripción existente, no configures billing_mode si la suscripción ya tiene uno. La programación hereda automáticamente el billing_mode de la suscripción original. Si configuras billing_mode al usar from_subscription, Stripe te devolverá un error. Si necesitas un billing_mode diferente, entonces crea una suscripción nueva.

Detallar descuentos de prorrateo

Si usas suscripciones flexibles, puedes definir tu comportamiento preferido para descuentos prorrateados en facturas y partidas de factura:

• Detallado Recommended: permite que facturas y partidas de factura muestren prorrateos con importes brutos e importes de descuento precisos, coherentes con los no prorrateos.
• Incluido: utiliza el comportamiento de visualización de prorrateo existente Stripe, con importe neto y cero importes de descuento monetario. Esta configuración se mantiene para la compatibilidad con versiones anteriores con integraciones anteriores.

Obtén más información sobre las diferencias entre detallado e incluido.

Para habilitar descuentos por prorrateo detallado, debes actualizar tu versión de API a 2025-06-30.basil o posterior.

Crear o migrar una suscripción para establecer proration_discounts en detallado.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-06-30.basil" \
  -d "items[0][price]"=
"{{PRICE_ID}}" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "billing_mode[type]"=flexible \
  -d "billing_mode[flexible][proration_discounts]"=itemized \
  -d payment_behavior=default_incomplete \
  -d "payment_settings[save_default_payment_method]"=on_subscription

El ejemplo de código anterior devuelve la siguiente respuesta:

{
  "id": "sub_JgRjFjhKbtD2qz",
  "object": "subscription",
  "billing_mode": {
    "flexible": {
      "proration_discounts": "itemized"
    },
    "type": "flexible",
    "updated_at": 1751071020
  },