Cómo establecer la fecha del ciclo de facturación de una suscripció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.

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

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.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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

Para alinear con precisión los períodos de facturación con otra suscripción, proporciona el mismo day_of_month que el original, así como la misma hour minute y second. Si omites los parámetros hour, minute y second, los valores se obtienen del momento de la creación de la suscripción.

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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d billing_cycle_anchor=1611008505

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ó.
• Si todos los precios son de valor cero, agregar uno o más precios ya pagados restablecerá inmediatamente el período de cobro. Para obtener más información sobre este caso, consulta la guía para cambiar a una categoría superior o inferior.

Restablece el ciclo de facturación al momento actual

Cuando restableces el ciclo de facturación, Stripe envía una factura de inmediato. Habilita la prorrata para acreditar al cliente por los días que ya pagó en el período anterior. Si deshabilitas la prorrata, es posible que cobres de más al cliente.

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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.

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

Facturación por uso

Con el cobro por uso, el precio que paga el cliente varía según el consumo durante el ciclo de cobro. Cuando modificar el ciclo de cobro supone la finalización anticipada de un intervalo de suscripción, le cobras al cliente el consumo acumulado durante un ciclo de cobro más corto.

Umbrales

Además de configurar las suscripciones según un ciclo estándar, puedes hacerlo de manera que se facturen cada vez que el importe adeudado alcance 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.

Para obtener más información, consulta umbrales de cobros.