# Configurar modelos de tarifas por consumo

Configura modelos de tarifas por consumo para tus suscripciones.

Las tarifas por consumo te permiten cobrar según el consumo que un cliente haga de tu producto o servicio. Las tarifas por consumo incluyen modelos como los siguientes:

- [Comisión fija y consumo excedente](https://docs.stripe.com/subscriptions/pricing-models/usage-based-pricing.md#fixed-fee-overage)
- [Pago por consumo](https://docs.stripe.com/subscriptions/pricing-models/usage-based-pricing.md#pay-as-you-go)
- [Reducción de créditos](https://docs.stripe.com/subscriptions/pricing-models/usage-based-pricing.md#credit-burndown)

## Comisión fija y consumo excedente

Usa el modelo de tarifa fija y cargos por excedente para cobrar una tarifa plana mensual por tu servicio al inicio del período. La tarifa fija incluye una cierta cantidad de consumo, y los cargos por consumo adicional (excedente) se aplican al final del período.

Puedes usar el Dashboard de Stripe o la API para configurar esto con dos precios dentro del mismo producto. Por ejemplo, imagina un negocio de IA llamado Hypernian que lanza un modelo avanzado llamado Hypernian Pro. Con una tarifa de 200 USD por mes, este modelo incluye 100,000 tokens. Cobran cualquier consumo que supere los tokens incluidos a una tarifa adicional de 0.001 USD por token.

#### Dashboard

1. En la página [Catálogo de productos](https://dashboard.stripe.com/test/products), haz clic en **Crear producto**.

1. En la página de **Añadir un producto**, haz lo siguiente:

   - Para **Nombre**, ingresa el nombre de tu producto. Para el ejemplo de Hypernian, ingresa «Hypernian».
   - (Opcional) En **Descripción**, agrega una descripción que aparece durante la confirmación de compra en el [portal de clientes](https://docs.stripe.com/customer-management.md) y en los [presupuestos](https://docs.stripe.com/quotes.md).
   - En **Período de facturación**, selecciona **Más opciones de tarifas**.

1. En la página de **Añadir precio**, haz lo siguiente:

   - En **Elige tu modelo de tarifas**, selecciona **Tarifa plana**.
   - En **Precio**, establece el **Importe** en 200 USD.
   - Haz clic en **Siguiente**.

1. Para agregar un segundo precio recurrente al producto, haz clic en **Agregar otro precio** en la página **Agregar un producto**.

1. En la página de **Añadir precio**, haz lo siguiente:

   - En **Elige tu modelo de tarifas**, selecciona **Por consumo**, **Por nivel** y **Escalonado**.

   - En **Precio**, crea dos niveles de tarifas escalonadas:

|                   | Primera unidad | Última unidad | Por unidad | Tarifa plana |
| ----------------- | -------------- | ------------- | ---------- | ------------ |
| **Primer nivel**  | 0              | 100,000       | 0 USD      | 0 USD        |
| **Segundo nivel** | 100,001        | ∞             | 0.001 USD  | 0 USD        |

1. En **Medidor**, crea un nuevo medidor para registrar consumo. Para el ejemplo de Hypernian, usa el nombre del medidor «tokens de la API de Hypernian» (hypernian_API_tokens).

1. Haz clic en **Siguiente**.

1. Haz click en **Agregar producto**. Cuando crees suscripciones, especifica ambos precios.

#### API

Primero, crea tu [producto](https://docs.stripe.com/api/products.md). Para el ejemplo de Hypernian, usa el nombre `Hypernian tokens`.

```curl
curl https://api.stripe.com/v1/products \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "name=Hypernian tokens"
```

Luego, se agrega un [precio](https://docs.stripe.com/api/prices.md) con tarifa plana al producto con una tarifa bajo licencia de 200 USD.

```curl
curl https://api.stripe.com/v1/prices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d product={{PRODUCT_ID}} \
  -d currency=usd \
  -d unit_amount=20000 \
  -d billing_scheme=per_unit \
  -d "recurring[usage_type]=licensed" \
  -d "recurring[interval]=month"
```

Luego, agrega un precio por consumo medido al producto con una tarifa escalonada en dos niveles.

Para el primer nivel, especifica de 0 a 100,000 unidades en 0 USD por unidad. Para el segundo nivel, especifica 0.001 USD por unidad. El primer nivel tiene un precio de 0 USD porque la tarifa plana incluye las primeras 100,000 unidades.

```curl
curl https://api.stripe.com/v1/prices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d product={{PRODUCT_ID}} \
  -d currency=usd \
  -d billing_scheme=tiered \
  -d "recurring[usage_type]=metered" \
  -d "recurring[interval]=month" \
  -d "recurring[meter]={{METER_ID}}" \
  -d tiers_mode=graduated \
  -d "tiers[0][up_to]=100000" \
  -d "tiers[0][unit_amount_decimal]=0" \
  -d "tiers[1][up_to]=inf" \
  -d "tiers[1][unit_amount_decimal]=0.1"
```

Por último, especifica ambos ID de precio al [crear una suscripción](https://docs.stripe.com/billing/subscriptions/usage-based/implementation-guide.md#create-subscription).

```curl
curl https://api.stripe.com/v1/subscriptions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]={{FLAT_MONTHLY_FEE_PRICE_ID}}" \
  -d "items[0][quantity]=1" \
  -d "items[1][price]={{METERED_USAGE_PRICE_ID}}"
```

## Pago por consumo

El modelo de pago por consumo (también llamado “cobro a plazo vencido”) te permite realizar un seguimiento del consumo incurrido durante un período determinado y luego cobrar al cliente al final del período.

Puedes utilizar cualquiera de las siguientes estrategias de precios:

- **Por unidad**: Cobra el mismo importe por cada unidad.
- **Por paquete**: Cobra un importe por un paquete o paquete de unidades o consumo.
- **Tarifas por volumen**: Cobra el ítem de suscripción en el nivel que corresponda al importe de consumo al final del período.
- **Tarifas escalonadas**: Cobra por el consumo en cada nivel en lugar de aplicar un solo precio a todo el consumo.

Este modelo puede hacer que los clientes acumulen un consumo significativo y afectar el estado de su método de pago a fin de mes.

## Reducción de créditos

El modelo de agotamiento del crédito te permite cobrar pagos por adelantado de productos y servicios basados en el consumo. Los clientes pueden usar [créditos de facturación](https://docs.stripe.com/billing/subscriptions/usage-based/billing-credits.md) para pagar un importe inicial y, luego, aplicar sus créditos de facturación a medida que usan el producto.

Por ejemplo, Hypernian quiere vender un contrato de una gran empresa a un cliente existente de autoservicio para su nuevo modelo de Hypernian. El cliente se compromete a pagar 100000 USD por adelantado a Hypernian a fin de obtener 120000 USD de consumo de crédito de facturación para usar en el transcurso de 1&nbsp;año.

#### Dashboard

#### Cobra por adelantado a un cliente

1. En la página [Facturas](https://dashboard.stripe.com/invoices), haz clic en **Crear factura**.
1. Selecciona a tu cliente desde el menú desplegable **Cliente**.
1. Selecciona la moneda correcta en el menú desplegable **Monedas**.
1. En **Ítems**, selecciona **Agregar una nueva partida de factura**.
1. En **Datos del ítem**, haz lo siguiente:
   - Para la **partida**, ingresa «Créditos de Hypernian».
   - Para **Precio**, escribe «100,000»
   - Haz clic en **Guardar**.
1. Haz clic en **Enviar factura**.

Después de que el cliente pague la factura, puedes otorgarle créditos de facturación.

#### Otorga créditos de facturación a un cliente

1. En la página de [Clientes](https://dashboard.stripe.com/test/customers)’, selecciona el nombre cliente.
1. En la página del cliente, en **Concesiones de crédito**, haz clic en el símbolo más (**+**).
1. En la página de **Nueva concesión de crédito**, haz lo siguiente:
   - Para **Nombre**, escribe un nombre para tu concesión de crédito.
   - Para **Importe**, especifica el importe de la concesión del crédito. Para el ejemplo de Hypernian, ingresa «120,000».
   - En **Fecha de vencimiento**, especifica la fecha, si la hay, en que vencen los créditos. Para el ejemplo de Hypernian, selecciona **Fecha específica** y establece una fecha dentro de 12&nbsp;meses.
   - Haz clic en **Crear concesión**.

#### API

Primero, crea una factura.

```curl
curl https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "description=Hypernian Credits" \
  -d customer={{CUSTOMER_ID}} \
  -d collection_method=charge_automatically
```

A continuación, agrega los créditos de facturación a la factura.

```curl
curl https://api.stripe.com/v1/invoiceitems \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer={{CUSTOMER_ID}} \
  -d currency=usd \
  -d unit_amount_decimal=10000000 \
  -d invoice={{INVOICE_ID}}
```

Después, finaliza la factura.

```curl
curl https://api.stripe.com/v1/invoices/{{INVOICE_ID}}/finalize \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d auto_advance=true
```

Después de que el cliente pague la factura, puedes otorgarle créditos de facturación.

```curl
curl https://api.stripe.com/v1/billing/credit_grants \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer={{CUSTOMER_ID}} \
  -d category=paid \
  -d "amount[type]=monetary" \
  -d "amount[monetary][value]=12000000" \
  -d "amount[monetary][currency]=usd" \
  -d "applicability_config[scope][price_type]=metered" \
  -d expires_at=1759341179
```