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.

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 un importe prorrateado por el tiempo transcurrido entre la fecha de inicio antedatada y la hora actual. El importe prorrateado se calcula en función de un intervalo imaginario que comienza en la fecha de inicio antedatada. Por ejemplo, si el intervalo de cobro es mensual el primer día del mes y estableces la backdate_start_date en el 15 de febrero (en un año no bisiesto), el cálculo del prorrateo se basa en un mes que va del 15 de febrero al 15 de marzo. Debido a que ese mes imaginario es de 28 días, el importe prorrateado para los 14 días 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, el cálculo del prorrateo se basa en un mes imaginario que va del 15 de enero al 15 de febrero. Debido a que ese mes es de 31 días, el importe prorrateado para los 17 días del 15 de enero al 1 de febrero es de 17 dividido 31 (o 0.548) de un cargo mensual normal.

Otra forma de pensar en el cálculo es considerar la fecha de inicio antedatada como la fecha de inicio original y el comienzo del primer período de facturación completo como una fecha de inicio actualizada.

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. Pasa una marca de tiempo Unix entera dentro del período actual de los elementos de la suscripción. Si la suscripción está respaldada por 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 de suscripciones.

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