Configurar la fecha de renovación de la facturación de la suscripción

El período 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 facturación es el punto de referencia que alinea las fechas de los futuros períodos de facturación. Configura el día de la semana de los intervalos de week, el día del mes para los intervalos de month y de 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 en el momento de crear la suscripción.

Los siguientes son ejemplos de suscripciones mensuales con diferentes períodos facturación:

• 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

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 toma en cuenta de forma automática los meses cortos y los años bisiestos. Si vas a crear una suscripción diaria o semanal, o si prefieres configurar la fecha de renovación 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 se renueve 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 se renueva el último día de ese mes.

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.

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 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.

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.

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

Cambia el período de facturación de las suscripciones existentes

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 importe cero, al agregar uno o más precios pagados se restablece inmediatamente el período de facturación. Consulta la guía para cambiar los precios de suscripción para obtener más información.
• El billing_cycle_anchor se restablece a la fecha cancel_at cuando se crea una suscripción con cancel_at establecida en una fecha anterior a la próxima renovación de la suscripción, o cuando se modifica una fecha cancel_at existente en una suscripción con un 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.

Restablecer el período de facturación al momento actual

To reset the billing cycle anchor to the current time, make an update request with billing_cycle_anchor set to now. This sets the billing cycle anchor to the time of the update request. After you reset the billing cycle anchor, Stripe immediately sends an invoice. Enable proration to credit the customer for any days already paid in the previous period. Disabling proration might result in overcharging your customer.

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

Cambia el período de facturación utilizando un período de prueba

You can change the billing cycle anchor by using a free trial to automatically set the billing cycle anchor date to the trial_end date.

Por ejemplo, si un cliente tiene una suscripción activa originalmente configurada para facturarse el 23 de julio, y el 15 de julio introduces un período de prueba que termina el 1 de agosto:

• El cliente recibirá una factura de USD 0 el 15 de julio. Ya pagaron hasta el 23 de julio en el ciclo anterior, por lo que el período “gratuito” solo se aplica del 24 de julio al 31 de julio.
• El cliente no recibirá la factura el 23 de julio.
• El nuevo ciclo facturado el 1 de agosto es un ciclo completo a la tarifa normal, y luego nuevamente el 1 de cada mes después de eso.

Como alternativa, puedes evitar el prorrateo cuando actualices una suscripción para iniciar una prueba usando proration_behavior=none. En la mayoría de los casos, si usas el período de prueba para cambiar el período de facturación sin la emisión de una factura prorrateada, deshabilitas el prorrateo porque la duración del período de prueba representa la parte ya pagada del período de facturación anterior.

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

Cobro por consumo

Con el cobro por consumo, el precio que paga el cliente varía en función del consumo durante el período de facturación. Cuando la modificación de este período de facturación supone que un período de servicio de la suscripción termine antes, le cobras al cliente por el consumo acumulado durante el período de facturación acortado.

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 configurada para que se facture de este modo, puedes configurarla de forma que se restablezca el período de servicio de la suscripción cuando alcance el umbral.