Suscripciones con fechas pasadas

Puedes poner un fecha anterior a una suscripción para cobrar a los clientes por un período ya transcurrido. Esto suele utilizarse durante la migración a Stripe o para fines contables. El campo backdate_start_date especifica la fecha a la que se antedata la suscripción. También tienes la opción de cobrar a los clientes por el período transcurrido y establecer la siguiente fecha de cobro.

Consideraciones sobre el modo de facturación

A partir de la versión de API 2025-04-30, el comportamiento de la configuración de una fecha anterior depende del billing_mode de tu suscripción:

Cómo antedatar y cobrar a los usuarios

A veces, los usuarios pueden tener acceso a tu servicio antes de que se cree la suscripción y quieres cobrarles por ese acceso.

Esto crea una factura con cargos por el tiempo transcurrido entre la fecha de inicio antedatada y la fecha de hoy.

Si una suscripción tiene billing_mode=classic, Stripe crea un único importe prorrateado para el período antedatado que se basa en un intervalo imaginario a partir de la fecha de inicio antedatada. Por ejemplo, si tienes un ciclo de facturación mensual que comienza el primer día del mes y estableces backdate_start_date en el 15 de febrero (en un año no bisiesto), Stripe calcula el prorrateo en función de un mes imaginario que va del 15 de febrero al 15 de marzo. Debido a que febrero tiene 28 días, el importe prorrateado para los 14 días que van del 15 de febrero al 1 de marzo es exactamente la mitad del importe de un cargo mensual normal.

Del mismo modo, si estableces la backdate_start_date en 15 de enero, Stripe basa el cálculo del prorrateo en un mes imaginario que va del 15 de enero al 15 de febrero. Ese mes imaginario tiene 31 días, por lo que el importe prorrateado para los 17 días que van del 15 de enero al 1 de febrero es de 17 dividido 31 (aproximadamente 0.548) de un cargo mensual normal.

También puedes ver el cálculo considerando la fecha de inicio antedatada como la fecha de inicio original. El comienzo del primer período de facturación completo se convierte en la fecha de inicio actualizada.

Si una suscripción tiene billing_mode=flexible, Stripe genera partidas de factura separadas para cada ciclo de facturación natural que se produjo durante el período antedatado. Esto significa que cada ciclo se trata como si Stripe lo hubiera facturado normalmente durante ese tiempo.

Cómo antedatar sin cobrar a los usuarios

También puedes poner una fecha anterior a una suscripción sin cobrarle al cliente por el período antedatado, que puedes usar si estás migrando a Stripe. Para hacerlo, especifica proration_behavior:' none ' al crear la suscripción. Eso establece la start_date en el mismo valor que backdate_start_date, pero no le cobra al cliente el tiempo antedatado.

Cómo antedatar y definir la delimitación del ciclo de facturación

Puedes combinar backdate_start_date con billing_cycle_anchor para antedatar una suscripción y establecer el anclaje del ciclo de cobro en una fecha futura. Esto crea un elemento prorrateado en la siguiente factura por el tiempo transcurrido entre la fecha de inicio antedatada y el anclaje del ciclo de cobro. Puedes usar esto si estás migrando a Stripe y necesitas transferir la próxima fecha de cobro de tus suscripciones mientras cobras a los clientes por el tiempo transcurrido.

Digamos que es 15 de octubre y estás migrando a Stripe. Tienes una suscripción que se inició el 1 de septiembre y la próxima fecha de cobro es el 1 de noviembre. Para migrar esa suscripción, crea una nueva suscripción y define 1 de septiembre como backdate_start_date y 1 de noviembre como billing_cycle_anchor.

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

En este ejemplo, se emite de inmediato una factura con un importe prorrateado por el tiempo transcurrido entre el 1 de septiembre y el 1 de noviembre. También se establece el 1 de septiembre como start_date de la suscripción. Stripe emite la próxima factura el 1 de noviembre.

Cómo antedatar una actualización

Para establecer la fecha de entrada en vigor de los prorrateos al actualizar una suscripción, usa el parámetro proration_date. Especifica una marca de tiempo Unix entera que se produzca dentro del período actual de los elementos de la suscripción. Si la suscripción usa un calendario de suscripciones, asegúrate de que la marca de tiempo sea anterior a la fecha de inicio de la siguiente fase del calendario.

Puedes establecer la proration_date antes del período actual solo durante el primer período de una suscripción antedatada. En este caso, la proration_date debe ser la misma o posterior a la subscription[start_date] (fecha de inicio anterior). En todos los demás casos, proration_date no puede ser anterior a current_period_start.