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.

If a subscription has billing_mode=classic, Stripe creates a single prorated amount for the backdated period based on an imagined interval starting from the backdated start date. For example, if you have a monthly billing period beginning on the first of the month and set backdate_start_date to February 15 (in a non-leap year), Stripe calculates the proration based on an imagined month running from February 15 to March 15. Because February has 28 days, the prorated amount for the 14 days from February 15 to March 1 is exactly half the amount of a normal monthly charge.

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.

If a subscription has billing_mode=flexible, Stripe generates separate line items for each natural billing period that occurred during the backdated period. This means that each cycle is treated as if Stripe billed it normally during that time.

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.