Ir a contenido
Crea una cuenta
o
Inicia sesión
Logotipo de Stripe Docs
/
Pregúntale a la IA
Crear una cuenta
Iniciar sesión
Empieza ahora
Pagos
Ingresos
Plataformas y marketplaces
Gestión del dinero
Recursos para desarrolladores
Resumen
Billing
ResumenAcerca de las API de facturación
Suscripciones
    Resumen
    Cómo funcionan las suscripciones
    Inicio rápido
    Casos de uso
    Desarrolla tu integración
    Funcionalidades de la suscripción
      Facturas de suscripciones
      Calendarios de suscripciones
      Precios de suscripciones
      Modelos de tarifas recurrentes
      Inserta un cuadro de tarifas
      Iniciar suscripciones
      Determinar cantidades
      Establecer ciclos de facturación
      Suscripciones con fechas pasadas
      Suscríbete a varios elementos
      Configura períodos de prueba
      Aplica cupones
      Migrar suscripciones a Stripe
      Cómo se calculan los prorrateos de crédito
      Pagos de suscripciones
      Métodos de pago de suscripciones
      Integra con el procesamiento de pagos de terceros
      Métodos de cobro
      Autenticación reforzada de clientes (SCA)
      Administración de suscripciones
      Modificar suscripciones
      Gestionar actualizaciones pendientes
    Derechos
    Análisis
Invoicing
Cobro por consumo
Presupuestos
Gestión de clientes
Gestión de cobros con otros productos
Recuperación de ingresos
Automatizaciones
Prueba tu integración
Impuesto
Resumen
Usa Stripe Tax
Gestiona el cumplimiento de la normativa
Elaboración de informes
Resumen
Seleccionar un informe
Configura informes
API de informes
Informes para varias cuentas
Reconocimiento de ingresos
Datos
ResumenEsquema
Informes personalizados
Data Pipeline
Gestión de datos
InicioIngresosSubscriptionsSubscription features

Cómo establecer la fecha del ciclo de facturación de una suscripción

Las suscripciones se facturan conforme a un ciclo. Aprende a establecer la fecha de facturación.

El ciclo de facturación de una suscripción depende de dos factores:

  • El intervalo recurrente del precio o de los precios (mensuales, anuales, semanales, etc.).
  • La delimitación del ciclo de cobro es el punto de referencia que alinea las fechas de los ciclos de cobro futuros. Establece el día de la semana para los intervalos de week, el día del mes para los intervalos de month e year y el mes del año para los intervalos de year. El valor predeterminado es la fecha de creación de la suscripción o la fecha de finalización de la prueba (si estás usando un período de prueba). También puedes establecer explícitamente este valor al momento de crear la suscripción.

Nota

Los delimitadores del ciclo de facturación son marcas temporales UNIX expresadas en segundos desde el punto de partida del sistema.

Los siguientes son ejemplos de suscripciones mensuales con diferentes ciclos de gestión de cobros:

  • Una suscripción mensual con una fecha de delimitación del ciclo de facturación establecida para el 2 de septiembre siempre se factura el segundo día del mes.
  • Una suscripción mensual con fecha de delimitación del ciclo de facturación establecida para el 31 de enero se factura el último día del mes más cercano a la fecha de delimitación; por ejemplo, el 28 de febrero (o el 29 de febrero en un año bisiesto); el 31 de marzo; el 30 de abril, etc.
  • Una suscripción semanal con una fecha de delimitación del ciclo de facturación establecida para el viernes 3 de junio se factura todos los viernes subsiguientes a partir de entonces.

Los períodos de facturación completos comienzan en la primera fecha de facturación completa, que suele ser la misma que la delimitación del ciclo de facturación y siempre está alineada con el intervalo.

Especifica la delimitación del ciclo de facturación para las suscripciones nuevas

Nota

El momento de creación de la suscripción coincide con el momento de la solicitud. No es lo mismo que la fecha de inicio de la suscripción. Obtén más información sobre la configuración de una fecha anterior y la delimitación del ciclo de cobro.

Hay dos maneras de establecer la delimitación del ciclo de facturación en las nuevas suscripciones:

  • Usa billing_cycle_anchor_config para calcular la marca de tiempo para ti (solo suscripciones mensuales o anuales).
  • Usa billing_cycle_anchor para aceptar la marca de tiempo directamente.

Si vas a crear una suscripción mensual o anual, te recomendamos usar el parámetro billing_cycle_anchor_config que automáticamente toma en cuenta los meses cortos y los años bisiestos. Si vas a crear una suscripción diaria o semanal, o si prefieres establecer la fecha del ciclo de tu suscripción con una marca de tiempo, usa el parámetro billing_cycle_anchor directamente.

Usa billing_cycle_anchor_config

Para crear una integración con las suscripciones mensuales y anuales, usa billing_cycle_anchor_config en crear una suscripción y especifica el día del mes en el que quieres marcar la delimitación.

Establece day_of_month en 31 para crear una suscripción mensual que concluya al final del mes, incluso en meses con menos de 31 días. Si un mes tiene menos de 31 días, la suscripción concluye el último día de ese mes.

Command Line
cURL
curl https://api.stripe.com/v1/subscriptions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d customer=
{{CUSTOMER_ID}}
\ -d "items[0][price]"=
{{PRICE_ID}}
\ -d "billing_cycle_anchor_config[day_of_month]"=31

También puedes especificar month para controlar el mes del año para la delimitación en suscripciones de varios meses y anuales.

Para crear un ciclo de tus suscripciones anuales el primero de julio, crea una suscripción anual con un month de 7 y day_of_month de 1.

Command Line
cURL
curl https://api.stripe.com/v1/subscriptions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d customer=
{{CUSTOMER_ID}}
\ -d "items[0][price]"=
{{PRICE_ID}}
\ -d "billing_cycle_anchor_config[month]"=7 \ -d "billing_cycle_anchor_config[day_of_month]"=1

Puedes especificar el mes, el día, la hora, el minuto y el segundo exactos para la delimitación del ciclo de cobro con billing_cycle_anchor_config. Si no especificas la hora, el minuto y el segundo, se establecerán de forma predeterminada los valores de la hora de creación de la suscripción.

La delimitación del ciclo de cobro utiliza la hora universal coordinada (UTC). Por ejemplo, si creas una suscripción con billing_cycle_anchor_config establecida a las 5 p. m. hora estándar del este (EST) sin especificar la hora, el horario se registrará en el sistema como 10 p. m. UTC.

billing_cycle_anchor_config no admite la delimitación en una fecha de inicio anterior.

Por ejemplo, si ya tienes una suscripción mensual con una marca de tiempo billing_cycle_anchor que contiene el día del mes, la hora, el minuto y el segundo de 15, 12, 30 y 0, puedes alinear una nueva suscripción mensual con ella. Para hacer esto, establece day_of_month, hour, minute y 'second para que coincidan con esos mismos valores, respectivamente.

Command Line
cURL
curl https://api.stripe.com/v1/subscriptions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d customer=
{{CUSTOMER_ID}}
\ -d "items[0][price]"=
{{PRICE_ID}}
\ -d "billing_cycle_anchor_config[day_of_month]"=15 \ -d "billing_cycle_anchor_config[hour]"=12 \ -d "billing_cycle_anchor_config[minute]"=30 \ -d "billing_cycle_anchor_config[second]"=0

Si usas billing_cycle_anchor_config, es posible que el resultado sea un billing_cycle_anchor que es más de un período de facturación en el futuro. Sin embargo, la primera fecha de factura completa siempre está dentro de un período de facturación desde la creación de la suscripción o la finalización de una prueba gratuita.

Por ejemplo, supongamos que creas una suscripción por intervalos de dos meses en febrero y la cierras al final de cada mes al establecer day_of_month en 31. El próximo mes que tiene 31 días en intervalos de dos meses a partir de febrero es agosto, lo que da como resultado una delimitación del ciclo de facturación el 31 de agosto. Sin embargo, la primera fecha de facturación completa para esta suscripción aún tiene lugar en febrero. Hay un período inicial prorrateado desde la creación de la suscripción hasta el 28 de febrero (o el 29 en un año bisiesto), seguido de un período de facturación completo de dos meses.

Usa billing_cycle_anchor

Puedes crear una suscripción con una fecha específica de delimitación del ciclo de facturación con la API Subscriptions o Checkout.

Usa la llamada crear una suscripción y establece una marca de tiempo para billing_cycle_anchor.

Command Line
cURL
curl https://api.stripe.com/v1/subscriptions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d customer=
{{CUSTOMER_ID}}
\ -d "items[0][price]"=
{{PRICE_ID}}
\ -d billing_cycle_anchor=1611008505

Configura el comportamiento de prorrata

Independientemente del parámetro de API que utilices, Stripe crea automáticamente una factura prorrateada para facturar por el período comprendido entre la fecha de creación de la suscripción y la primera fecha de factura completa.

Si no quieres cobrar inmediatamente a un cliente por el período comprendido entre la creación de la suscripción y la primera fecha de factura completa, haz lo siguiente:

  • Para deshabilitar el prorrateo, establece proration_behavior en none, lo que hace que el período inicial hasta la primera fecha de factura completa sea gratuito. Esta acción no genera ninguna factura hasta el primer ciclo de cobro.
  • Para combinar una prueba con billing_cycle_anchor, establece trial_end en una marca de tiempo que represente la fecha en que finaliza la prueba gratuita. Según la duración de la prueba gratuita y el número de días hasta la primera fecha de factura completa, esta opción podría dar lugar a una factura prorrateada después del período de prueba. Por ejemplo, una prueba gratuita dura siete días y el ciclo de cobro es mensual, comenzando el día 1. Si el cliente se suscribe el día 15, generaremos una factura prorrateada el día 22 por el período comprendido entre el día 22 y el día 1, y desde entonces, facturamos el importe total el día 1 de cada mes. Si un cliente se suscribe el día 28, la prueba gratuita se extiende más allá del día 1 y se genera una factura prorrateada hasta el mes siguiente.

Cambia el ciclo de facturación en suscripciones preexistentes

Usa la API Subscriptions o el Dashboard para cambiar la fecha de cobro de una suscripción existente a través de una de las siguientes opciones:

  • Restablece la fecha de delimitación del ciclo de facturación a la hora actual.
  • Agrega una prueba gratuita. Esto establecerá automáticamente la fecha de delimitación para el final del período de prueba. Por lo general, las pruebas comienzan cuando creas una suscripción, pero también puedes aplicarlas a las suscripciones que ya existen. Esto te permite acreditar al cliente por los días restantes del ciclo anterior que ya pagó.

La fecha de tu ciclo de facturación cambia en estos escenarios. No obstante, si creas o actualizas una suscripción con billing_mode[type]=flexible, la delimitación del ciclo de facturación no variará. Obtén más información sobre cómo configurar el modo de facturación flexible y sus limitaciones.

  • Si todos los precios son de valor cero, agregar uno o más precios ya pagados restablecerá inmediatamente el período de facturación. Para obtener más información, consulta la guía sobre cambios de precios de suscripción.
  • El billing_cycle_anchor se restablece a la fecha cancel_at cuando se crea una suscripción con cancel_at establecido en una fecha anterior al siguiente ciclo de suscripción o cuando se modifica una fecha cancel_at existente en una suscripción con billing_cycle_anchor en el futuro de la nueva fecha cancel_at.
  • El billing_cycle_anchor se restablece al momento actual cuando se cambia a un precio con un recurring.interval diferente.

Restablece el ciclo de facturación al momento actual

Para restablecer el anclaje del ciclo de facturación, realiza una solicitud de actualización con billing_cycle_anchor establecido en now. Esto establece el anclaje del ciclo de facturación a la hora de la solicitud de actualización. Cuando restableces el anclaje del ciclo de facturación, Stripe envía inmediatamente una factura. Habilita el prorrateo para acreditar al cliente los días ya pagados en el período anterior. Si desactivas el prorrateo, es posible que le cobres de más a tu cliente.

Usa la llamada actualizar la suscripción y configura billing_cycle_anchor en now y proration_behavior en create_prorations para evitar cobrar de más al cliente por los días que ya pagó del ciclo anterior.

Command Line
cURL
curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d billing_cycle_anchor=now \ -d proration_behavior=create_prorations

Agrega una prueba para cambiar el ciclo de facturación

Agregar un período de prueba no prorrateado a una suscripción que ya existe te permite configurar la fecha del ciclo de facturación.

Por lo general, si utilizas el período de prueba para cambiar el ciclo de facturación sin emitir una factura prorrateada, desactivas la prorrata porque la duración del período de prueba representa la parte ya pagada del ciclo de facturación anterior.

Supongamos que un cliente tiene una suscripción activa que se facturará el 23 de julio, y tú introduces un período de prueba hasta el 1 de agosto, sucederá lo siguiente:

  • El cliente recibirá una factura de USD 0 el 15 de julio.
  • El cliente no recibirá la factura el 23 de julio.
  • El cliente recibirá la factura de nuevo el 1 de agosto, luego el 1 de septiembre, y así sucesivamente.
  • El cliente ya pagó hasta el 23 de julio en el ciclo anterior, por lo que ese período «gratuito» realmente no lo es.
  • El período comprendido entre el 23 y el 31 de julio no se cobra.
  • El nuevo ciclo facturado el 1 de agosto es un ciclo completo a la tarifa normal.

Usa la llamada actualizar suscripción y establece trial_end en una marca de tiempo de Unix que represente la fecha de finalización del período de prueba y la nueva fecha de delimitación del ciclo de cobro. Además, establece proration_behavior en none.

Command Line
cURL
curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d trial_end=1611008505 \ -d proration_behavior=none

Cobro por consumo

With usage-based billing, the price paid by the customer varies based on consumption during the billing cycle. When changing the billing cycle results in ending a subscription interval early, you charge the customer for the usage accrued during the shortened billing cycle.

Umbrales

Además del ciclo normal, puedes configurar suscripciones para que se cobren cada vez que el importe adeudado alcanza un umbral.

Si hay una suscripción que se configuró para que se facture de este modo, puedes establecerla de forma que se restablezca el ciclo de suscripción cuando alcance el umbral.

Consulta también

  • Cómo usar períodos de prueba
  • Actualiza una suscripción
¿Te fue útil esta página?
SíNo
¿Necesitas ayuda? Ponte en contacto con soporte.
Únete a nuestro programa de acceso anticipado.
Echa un vistazo a nuestro registro de cambios.
¿Tienes alguna pregunta? Contacto.
¿LLM? Lee llms.txt.
Con tecnología de Markdoc
Guías relacionadas
Utiliza los clocks de prueba para acceder a una vista previa de las facturas
Productos utilizados
Billing