Prorrateos

The most complex aspect of changing existing subscriptions are prorations, where the customer is charged a percentage of a subscription’s cost to reflect partial use. This page explains how prorations work with subscriptions and how to manage prorations for your customers.

Cómo funcionan los prorrateos

Por ejemplo, por pasar de un plan a otro, una suscripción puede generar cargos prorrateados. Si un cliente pasa de un plan mensual de USD 10 a un plan que cuesta USD 20, se le cobrarán importes prorrateados por el tiempo que utilizó cada plan. Si el cambio se produjera a mitad del período de cobro, al cliente se le cobraría USD 5 adicionales: -USD 5 por el tiempo no utilizado conforme al precio inicial y USD 10 por el tiempo restante conforme al nuevo precio.

El prorrateo garantiza que al cliente se le cobre el importe correcto, pero puede traer aparejados importes de pago diferentes de lo previsto. Los prorrateos negativos no se le reembolsan al cliente automáticamente ni los positivos se le cobran de inmediato, aunque ambas acciones pueden hacerse en forma manual.

Puedes previsualizar el prorrateo para ver el importe antes de aplicar los cambios.

Prorrateos y descuentos

Any adjustments from discounts are reflected in the proration invoice item’s amount. Additional discounts at the invoice item level or invoice line item level don’t apply to prorations because they have discountable=false.

This behavior is different from non-prorations, which show discount adjustments in discount_amounts.

Qué desencadena los prorrateos

De forma predeterminada, los siguientes casos dan como resultado un prorrateo:

• El cambio a un precio con un costo base diferente.
• El cambio a un precio con un intervalo de cobro diferente.
• La incorporación de un período de prueba a una suscripción activa
• El cambio de la cantidad.
• Suscripciones bajo licencia (por usuario) (porque se les cobra al inicio de cada período de cobro)

Crear manualmente tus propios prorrateos

Para calcular tus propios prorrateos fuera de Stripe y agregarlos a la suscripción, especifica add_invoice_items con valores negativos de unit_amount (iguales al monto del prorrateo calculado) en estos puntos de conexión:

• Crea una suscripción
• Actualiza una suscripción
• Crea un calendario de suscripciones
• Actualiza los calendarios de suscripciones

Cuándo se aplican los prorrateos

Los prorrateos solo se aplican a los cargos que ocurren antes del ciclo de cobro. El fcobro por uso no está sujeto al prorrateo.

El importe prorrateado se calcula en cuanto la API actualiza la suscripción. El momento de inicio y finalización del período de facturación en curso se utilizan para calcular el costo de la suscripción antes y después del cambio.

Impuestos y prorrateos

Para obtener más información sobre cómo funcionan los impuestos con los prorrateos, consulta la sección Cobra impuestos sobre pagos recurrentes.

Previsualizar un prorrateo

Puedes recuperar la próxima factura para previsualizar los cambios de una suscripción. Esta llamada API no modifica la suscripción, sino que devuelve la próxima factura en función de los parámetros especificados. Si se cambia price o quantity, se produce un prorrateo. En este ejemplo, se modifica el price y se define una fecha para el prorrateo.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

# Set proration date to this moment:
proration_date = Time.now.to_i

subscription = Stripe::Subscription.retrieve('sub_49ty4767H20z6a')

# See what the next invoice would look like with a price switch
# and proration set:
items = [{
  id: subscription.items.data[0].id,
  price: 'price_CBb6IXqvTLXp3f', # Switch to new price
}]

invoice = Stripe::Invoice.upcoming({
  customer: 'cus_4fdAW5ftNQow1a',
  subscription: 'sub_49ty4767H20z6a',
  subscription_items: items,
  subscription_proration_date: proration_date,
})

Puedes expandir la siguiente respuesta de ejemplo para ver:

• El crédito por el tiempo no utilizado conforme al precio anterior en las líneas 36-38.
• El costo por el tiempo de uso conforme al nuevo precio en las líneas 107-109.
• El nuevo subtotal y el 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",

Usa esta información para confirmar los cambios con el cliente antes de modificar la suscripción. Debido a que Stripe prorratea hasta los segundos, los importes prorrateados pueden cambiar entre el momento en que se previsualizan y el momento en que se hace la actualización. Para evitarlo, especifica subscription_proration_date en la factura al previsualizar el cambio. Cuando actualices la suscripción, puedes especificar la misma fecha con el parámetro proration_date en la suscripción para que el prorrateo se calcule al mismo tiempo.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

subscription = Stripe::Subscription.update(
  'sub_49ty4767H20z6a',
  {
    items: [
      {
        id: subscription.items.data[0].id,
        price: 'price_CBb6IXqvTLXp3f',
      },
    ],
    proration_date: proration_date,
  }
)

Deshabilitar prorrateos

El parámetro proration_behavior controla el prorrateo, y, de manera predeterminada, está establecido en create_prorations.

Para deshabilitar los prorrateos en función de una solicitud, establece el parámetro proration_behavior en none. Ningún parámetro desactiva todos los próximos prorrateos de una suscripción. Si deseas deshabilitar los prorrateos indefinidamente, establece proration_behavior en none para cada solicitud que genere prorrateos:

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "items[0][id]"="si_1AkFf6LlRB0eXbMtRFjYiJ0J" \
  -d "items[0][price]"="price_CBb6IXqvTLXp3f" \
  -d "proration_behavior"="none"

Si se han deshabilitado los prorrateos, al generarse la siguiente factura, se les facturará a los cliente el importe total conforme al nuevo precio.