Prorrateos
Los cambios a una suscripción como la [actualización o
El importe prorrateado se calcula tan pronto como la API actualiza la suscripción. Las horas de inicio y finalización del período de facturación actual se utilizan para calcular el costo de la suscripción antes y después del cambio.
Nota
Los prorrateos se crean solo para suscripciones con licencia (por cantidad de usuarios) porque se facturan al inicio de cada período de facturación.
For information about how taxes work with prorations, see Collect taxes for recurring payments.
Previsualizar un prorrateo
Puedes recuperar una próxima factura para previsualizar los cambios en una suscripción. Esta llamada a la API no modifica la suscripción, devuelve la próxima factura basándose solo en los parámetros que hayas especificado. Si se cambia price
o quantity
, se produce un prorrateo. En este ejemplo, se cambia price
y se define una fecha para el prorrateo.
Puedes expandir la siguiente respuesta de eejemplo para ver:
- El crédito por el tiempo no utilizado al precio anterior en las líneas 36-38
- El costo del tiempo transcurrido al nuevo precio en las líneas 107-109.
- El nuevo subtotal y total de la factura en las líneas 276-279.
{ "account_country": "US", "account_name": "Test account", "amount_due": 3627, "amount_paid": 0, "amount_remaining": 3627, "application_fee_amount": null, "attempt_count": 0, "attempted": false, "billing_reason": "upcoming",
Puedes utilizar esta información para confirmar los cambios con el cliente antes de modificar la suscripción. Debido a que Stripe prorratea al segundo, los importes prorrateados puede cambiar entre la hora en que se previsualizan y la hora en que se realiza la actualización. Para evitar esta situación, debes especificar subscription_proration_date
en la factura cuando previsualices un cambio. Cuando actualices la suscripción, puedes especificar la misma fecha usando el parámetro proration_date
en la suscripción para que el prorrateo se calcule a la misma hora.
Deshabilitar prorrateos
Prorating is controlled by the proration_behavior
parameter and defaults to create_prorations
.
You can disable prorations on a per-request basis by setting the proration_behavior
parameter to none
. There is no parameter that turns off all future prorations for a Subscription. If you want to disable prorations indefinitely, you need to set proration_behavior
to none
for every request that generates prorations:
Cuando se deshabilitan los prorrateos, se factura a los cliente el importe completo al nuevo precio cuando se genera la siguiente factura.