# Configurar tarifas escalonadas Configura tarifas escalonadas para tus suscripciones. Los precios pueden representar niveles, lo que permite que el costo unitario cambie con la cantidad o el consumo. Utiliza niveles si necesitas aplicar tarifas no lineales cuando cambie la `cantidad` o el [consumo](https://docs.stripe.com/api/billing/meter-event.md). Para crear [modelos de tarifas basadas en el consumo](https://docs.stripe.com/subscriptions/pricing-models/usage-based-pricing.md), puedes combinar tarifas escalonadas con tarifas fijas. Por ejemplo, imagina una empresa llamada [Tipografía](https://typographic.io/) que quiere ofrecer tarifas más bajas a los clientes que utilicen más fuentes al mes. Los siguientes modelos de tarifas escalonadas muestran dos formas diferentes de ajustar los precios a medida que aumenta el consumo: [tarifas por volumen](https://docs.stripe.com/subscriptions/pricing-models/tiered-pricing.md#volume-based-pricing) y [tarifas escalonadas](https://docs.stripe.com/subscriptions/pricing-models/tiered-pricing.md#graduated-pricing). Para demostrar estos enfoques de tarifas escalonadas, utilizaremos los siguientes niveles: | | Cantidad de fuentes | Precio por nivel | | ----------------- | ------------------- | ---------------- | | **Primer nivel** | Entre 1 y 5 | 7 USD | | **Segundo nivel** | Entre 6 y 10 | 6.5 USD | | **Tercer nivel** | Más de 11 | 6 USD | ## Tarifas por volumen Con la tarifa por volumen, el ítem de suscripción se factura según el nivel correspondiente a la cantidad de consumo al final del período. La `quantity` (o `usage`) completa se multiplica por el costo unitario del nivel. Debido a que el precio del nivel se aplica a toda la `quantity` (o `usage`), el total podría disminuir al calcular el costo final. Por ejemplo, a un cliente con 5 fuentes se le cobra 35 USD (5 × 7 USD) en noviembre. Si usa 6 fuentes en diciembre, entonces, Tipografía factura todas las fuentes a la tasa de `entre 6 y 10`. Para diciembre, Tipografía cobra 39 USD (6 × 6.5 USD). | Cantidad y consumo al final del período | Costo por unidad | Costo mensual total | | --------------------------------------- | ---------------- | ------------------- | | 1 | 7 USD | 7 USD | | 5 | 7 USD | 35 USD | | 6 | 6.5 USD | 39 USD | | 20 | 6 USD | 120 USD | | 25 | 6 USD | 150 USD | #### Dashboard 1. Ve al [catálogo de productos](https://dashboard.stripe.com/products). 1. Haz clic en **+ Crear producto**. 1. Ingresa el **Nombre** del producto. 1. (Opcional) Agrega una **Descripción**. La descripción aparece en el proceso de compra, en el [portal de clientes](https://docs.stripe.com/customer-management.md) y en [presupuestos](https://docs.stripe.com/quotes.md). Acto seguido, crea el precio mensual para el producto: 1. Haz clic en **Más opciones de tarifas**. 1. Selecciona **Recurrente**. 1. En **Elige tu modelo de tarifas**, selecciona **Tarifas escalonadas** y **Volumen**. 1. En **Precio**, crea tres niveles: | | Primera unidad | Última unidad | Por unidad | Tarifa plana | | ------------- | -------------- | ------------- | ---------- | ------------ | | Primer nivel | 1 | 5 | 7 USD | 0 USD | | Segundo nivel | 6 | 10 | 6.5 USD | 0 USD | | Tercer nivel | 11 | ∞ | 6 USD | 0 USD | 1. Para el **Período de facturación**, selecciona **Mensual**. 1. Haz click en **Agregar producto** para guardar el producto y el precio. Solo puedes editar el producto y el precio hasta que crees una suscripción con ellos. #### API Crea los niveles para que coincidan con el ejemplo y establece el valor de `tiers_mode` en `volume`: ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d "nickname=Font Volume Pricing" \ -d "tiers[0][unit_amount]=700" \ -d "tiers[0][up_to]=5" \ -d "tiers[1][unit_amount]=650" \ -d "tiers[1][up_to]=10" \ -d "tiers[2][unit_amount]=600" \ -d "tiers[2][up_to]=inf" \ -d currency=usd \ -d "recurring[interval]=month" \ -d "recurring[usage_type]=metered" \ -d "product={{PRODUCT_ID}}" \ -d tiers_mode=volume \ -d billing_scheme=tiered \ -d "expand[0]=tiers" ``` ## Tarifas escalonadas Cargos por tarifas escalonadas por el consumo de cada nivel en lugar de aplicar un precio único por consumo general. La `cantidad` se multiplica por el importe de cada nivel, y los totales de cada nivel se suman. Por ejemplo, 5 fuentes dan lugar al mismo pago que los precios establecidos en función del volumen: 35 USD hace un total de 7 USD por fuente. Esto cambia a medida que el consumo supera el primer nivel. Tipografía le cobra a un cliente con más de 5 tipos de fuente 7 USD por fuente para los primeros 5 tipos de fuente; luego, 6.5 USD para las fuentes de 6 a 10, y 6 USD para fuentes adicionales. A un cliente con 6 fuentes se le cobra 41.5 USD, 35 USD por las 5 primeras fuentes y 6.5 USD por la 6.ª fuente. | Cantidad y consumo al final del período | Total de las tarifas por niveles escalonadas | | --------------------------------------- | -------------------------------------------- | | 1 | 7 USD | | 5 | 35 USD | | 6 | 41.5 USD | | 20 | 127.5 USD | | 25 | 157.5 USD | #### Dashboard 1. Ve al [catálogo de productos](https://dashboard.stripe.com/products). 1. Haz clic en **+ Crear producto**. 1. Ingresa el **Nombre** del producto. 1. (Opcional) Agrega una **Descripción**. La descripción aparece en el proceso de compra, en el [portal de clientes](https://docs.stripe.com/customer-management.md) y en [presupuestos](https://docs.stripe.com/quotes.md). Acto seguido, crea el precio mensual para el producto: 1. Haz clic en **Más opciones de tarifas**. 1. Selecciona **Recurrente**. 1. En **Elige tu modelo de tarifas**, selecciona **Tarifas escalonadas** y **Escalonadas**. 1. En **Precio**, crea tres niveles: | | Primera unidad | Última unidad | Por unidad | Tarifa plana | | ------------- | -------------- | ------------- | ---------- | ------------ | | Primer nivel | 1 | 5 | 7 USD | 0 USD | | Segundo nivel | 6 | 10 | 6.5 USD | 0 USD | | Tercer nivel | 11 | ∞ | 6 USD | 0 USD | 1. Para el **Período de facturación**, selecciona **Mensual**. 1. Haz click en **Agregar producto** para guardar el producto y el precio. Solo puedes editar el producto y el precio hasta que crees una suscripción con ellos. #### API Crea los niveles para que coincidan con el ejemplo y establece el valor de `tiers_mode` en `graduated`: ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d "nickname=Per-minute pricing" \ -d "tiers[0][unit_amount]=700" \ -d "tiers[0][up_to]=5" \ -d "tiers[1][unit_amount]=650" \ -d "tiers[1][up_to]=10" \ -d "tiers[2][unit_amount]=600" \ -d "tiers[2][up_to]=inf" \ -d currency=usd \ -d "recurring[interval]=month" \ -d "recurring[usage_type]=metered" \ -d "product={{PRODUCT_ID}}" \ -d tiers_mode=graduated \ -d billing_scheme=tiered \ -d "expand[0]=tiers" ``` ## Agregar una tarifa plana Puedes especificar una tarifa plana (`flat_amount`) para agregar a la *factura* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice). Esto funciona tanto para precios por volumen como para precios escalonados. Por ejemplo, puedes tener una tarifa fija que aumente cuando tu cliente supera ciertos umbrales de consumo: | Nivel | Importe (costo por unidad) | Tarifa plana | | -------------------------- | -------------------------- | --------------------------- | | Entre 1 y 5 (`up_to=5`) | 5 USD (`unit_amount=500`) | 10 USD (`flat_amount=1000`) | | Entre 6 y 10 (`up_to=10`) | 4 USD (`unit_amount=400`) | 20 USD (`flat_amount=2000`) | | Entre 10 y 15 (`up_to=15`) | 3 USD (`unit_amount=300`) | 30 USD (`flat_amount=3000`) | | Entre 15 y 20 (`up_to=20`) | 2 USD (`unit_amount=200`) | 40 USD (`flat_amount=4000`) | | Más de 20 (`up_to=inf`) | 1 USD (`unit_amount=100`) | 50 USD (`flat_amount=5000`) | #### Ejemplo de tarifa plana con precios establecidos por volumen Si la `quantity` es `12` y `tiers_mode=volume`, el importe total facturado es: 12 × 3 USD + 30 USD = 66 USD #### Ejemplo de tarifa plana con precios escalonados Si la `quantity` es `12` y `tiers_mode=graduated`, el importe total facturado es: (5 × 5 USD + 10 USD) + (5 × 4 USD + 20 USD) + (2 × 3 USD + 30 USD) = 111 USD Un nivel puede tener un `unit_amount` o un `flat_amount`, o ambos, pero debe tener al menos uno de los dos. Si `quantity` es `0`, el importe total es 10 USD independientemente del modelo de tarifas escalonadas que se use. Stripe siempre factura el primer nivel de tarifa plana cuando `quantity=0`. Para facturar `0` cuando no hay consumo, configura un nivel `up_to=1` con un `unit_amount` igual a la tarifa plana y omite `flat_amount`.