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

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

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.

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.

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 en función del consumo durante el ciclo de cobro. Cuando la modificación de este ciclo supone que un intervalo de suscripción termine antes, le cobras al cliente por el consumo acumulado durante el ciclo de cobro acortado.