Prorrateos

El aspecto más complejo a la hora de modificar suscripciones existentes son los prorrateos, mediante los que se le cobra al cliente un porcentaje del costo de la suscripción para reflejar un uso parcial. En esta página se explica cómo funcionan los prorrateos con las suscripciones y cómo administrar los prorrateos para tus clientes.

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. Sin embargo, ambas acciones pueden hacerse en forma manual.

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

Prorrateos y descuentos

Los ajustes de los descuentos se reflejan en el importe de la partida de factura de prorrateo. Otros descuentos en las partidas de factura o en los detalles de partidas de factura no se aplican a los prorrateos porque tienen discountable=false.

Este comportamiento es diferente de los no prorrateos, que muestran ajustes de descuento en 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

You can create a preview invoice to preview changes to a subscription. This API call doesn’t modify the subscription. Instead, it returns the upcoming invoice based only on the parameters that you pass. Changing the price or quantity both result in a proration. This example changes the price and sets a date for the proration.

# 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_BQokikJOvBiI2HlWgH4olfQ2'

# 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.create_preview({
  customer: 'cus_4fdAW5ftNQow1a',
  subscription: 'sub_49ty4767H20z6a',
  subscription_details: {
    items: items,
    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.

{
  "id": "upcoming_in_1OujwkClCIKljWvsq5v2ICAN",
  "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,

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_BQokikJOvBiI2HlWgH4olfQ2'

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

Controla el comportamiento de prorrateo

El prorrateo se controla mediante el parámetro proration_behavior, que tiene tres opciones de parámetros posibles: create_prorations, always_invoice y none.

Comportamiento predeterminado

El parámetro predeterminado para proration_behavior es create_prorations, que crea partidas de factura de prorrateo cuando corresponda. Estas partidas de prorrateo solo se facturan de inmediato cuando se dan ciertas condiciones.

Crea prorrateos inmediatos

Para cobrar de inmediato a un cliente por un cambio en una suscripción en el mismo ciclo de cobro, establece proration_behavior en always_invoice cuando modifiques la suscripción. De este modo, se calcula el prorrateo y, luego, se genera inmediatamente una factura.

Deshabilitar prorrateos

Para deshabilitar los prorrateos por solicitud, establece el parámetro proration_behavior en none. Ningún parámetro desactiva todos los prorrateos futuros de una suscripción. Para deshabilitar los prorrateos de manera indefinida, establece proration_behavior en none en cada solicitud que genere prorrateos:

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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.