Definir cantidades en las suscripciones

De manera predeterminada, cada suscripción corresponde a un solo producto, pero Stripe permite que los clientes se suscriban a varias cantidades de un producto. Por ejemplo, supongamos que tienes una empresa de alojamiento web y que los clientes usan tu servicio para alojar sus sitios web a un costo de USD 9.99 por sitio, por mes. La mayoría de los clientes alojan un solo sitio; algunos alojan varios. Podrías crear precios por alojar un sitio (USD 9.99), dos sitios (USD 19.98) y así sucesivamente, pero es mejor que los clientes se suscriban por cantidad y que el precio unitario sea USD 9.99.

Las suscripciones tienen dos tipos de cobro por consumo: el cobro por uso y las licencias por usuario. Puedes habilitar estos modelos de cobro estableciendo el valor del atributo recurring[usage_type] al crear un precio. Al crear una suscripción, solo puedes especificar una cantidad si el valor de recurring[usage_type] es licensed. Si quieres un cobro detallado por consumo que fluctúa dentro de un mismo intervalo de cobro, considera la posibilidad de usar el cobro por uso en lugar de cobrar por cantidad.

Cómo definir varias cantidades

Para definir la cantidad en una suscripción, especifica un valor de quantity al crear o actualizar la suscripción:

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=cus_4fdAW5ftNQow1a \
  -d "items[0][price]"=price_CBb6IXqvTLXp3f \
  -d "items[0][quantity]"=5

Aun así, puedes cobrar varias cantidades en una sola factura y prorratearlas cuando cambia la suscripción. Esto incluye los cambios de cantidad en la suscripción.

Cómo cobrar diferentes importes en función de la cantidad

Es posible que en algunos casos quieras ajustar el costo por usuario según la cantidad de usuarios en la suscripción. Por ejemplo, puedes ofrecer descuentos por volumen de licencias para las suscripciones que superen determinados umbrales de cantidad. Puedes usar niveles para ajustar las tarifas por usuario.

Transformación de cantidades

Cuando factures a los clientes, quizá te convenga hacer un seguimiento del consumo en una forma más detallada que en la factura. Por ejemplo, piensa en un paquete de software de productividad que cuesta USD 10 por cada 5 usuarios (o fracción) que usan el producto. Sin la transformación de cantidades, sería necesario aumentar la quantity del ítem de suscripción en 1 por cada 5 usuarios.

Con el parámetro transform_quantity, puedes indicarle a Stripe que transforme la cantidad antes de aplicar el costo por unidad. En la siguiente suscripción, puedes informar la cantidad actual de usuarios normalmente como la quantity del ítem de suscripción. El sistema de facturación de Stripe divide esa cantidad por 5 y la redondea hacia arriba antes de calcular el costo por unidad.

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d nickname="Standard Cost Per 5 Users" \
  -d "transform_quantity[divide_by]"=5 \
  -d "transform_quantity[round]"=up \
  -d unit_amount=1000 \
  -d currency=usd \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=licensed \
  -d product={{PRODUCTIVITY_SUITE_ID}}

Actualmente, la única transformación disponible es la división, que se hace usando el parámetro divide_by junto con el parámetro round.

Solo puedes usar transform_quantity con billing_scheme=per_unit, ya que no es compatible con las tarifas por niveles.

Redondeo

En el ejemplo anterior, se mostró una suscripción que cobraba por cada 5 usuarios, redondeando hacia arriba (es decir, 6 dividido por 5 daba una cantidad de 2). Para los casos de uso en los que no quieras cobrar por una fracción de consumo, sino que quieras cobrar, por ejemplo, por cada gigabyte entero de consumo de un servicio de Internet de banda ancha, también puedes especificar down como valor de round.

Consumo medido

Junto con la facturación por uso, también puedes aplicar transform_quantity. Esta transformación se aplica a los precios con recurring[usage_type]=metered al final de un período de facturación de la misma manera que se aplica a quantity para los precios con recurring[usage_type]=licensed.

Un servicio de correos electrónicos de marketing que fija un precio por uso para cobrar USD 0.10 por cada 1000 mensajes enviados podría verse así:

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d nickname="Metered Emails" \
  -d "transform_quantity[divide_by]"=1000 \
  -d "transform_quantity[round]"=down \
  -d unit_amount=10 \
  -d currency=usd \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=metered \
  -d product={{MARKETING_EMAILS_ID}}

Con esta suscripción, el consumo puede informarse por correo electrónico, y puedes facturar al cliente USD 0.10 por cada 1000 correos enviados.