# Estabeleça modelos de planos de preços com base no uso

Estabeleça modelos de planos de preços com base no uso para suas assinaturas.

O plano de preços com base no uso permite que você cobre de acordo com o uso que o cliente faz do seu produto ou serviço. O plano de preços com base no uso inclui modelos como:

- [Tarifa fixa e excedente](https://docs.stripe.com/subscriptions/pricing-models/usage-based-pricing.md#fixed-fee-overage)
- [Pagamento por consumo](https://docs.stripe.com/subscriptions/pricing-models/usage-based-pricing.md#pay-as-you-go)
- [Queima de crédito](https://docs.stripe.com/subscriptions/pricing-models/usage-based-pricing.md#credit-burndown)

## Tarifa fixa e excedente

Utilize o modelo de precificação por tarifa fixa com excedente para cobrar uma taxa mensal fixa no início de cada ciclo, referente ao seu serviço. A tarifa fixa inclui uma quantidade de uso prevista e, ao final do período, são cobrados encargos adicionais pelo uso excedente.

Você pode usar o Stripe Dashboard ou a API para configurar isso com dois preços dentro do mesmo produto. Por exemplo, imagine que uma empresa de IA chamada Hypernian lança um modelo avançado chamado Hypernian Pro. Com preço de 200 USD por mês, este modelo inclui 100 mil tokens. Ela cobra qualquer uso acima dos tokens incluídos a uma taxa adicional de 0.001 USD por token.

#### Dashboard

1. Na página [Catálogo de produtos](https://dashboard.stripe.com/test/products), clique em **Criar produto**.

1. Na página **Adicionar produto**, faça o seguinte:

   - Em **Nome**, insira o nome do seu produto. No exemplo da Hypernian, insira “Hypernian.”
   - (Opcional) Em **Descrição**, adicione uma descrição que aparece no checkout no [portal do cliente](https://docs.stripe.com/customer-management.md) e nas [cotações](https://docs.stripe.com/quotes.md).
   - Em **Período de cobrança**, selecione **Mais opções de planos de preços**.

1. Na página **Adicionar preço**, faça o seguinte:

   - Em **Escolher modelo de preços**, selecione **Tarifa fixa**.
   - Em **Preço**, defina o **Valor** como 200 USD.
   - Clique em **Próximo**

1. Para adicionar um segundo preço recorrente ao produto, clique em **Adicionar outro preço** na página **Adicionar um produto**.

1. Na página **Adicionar preço**, faça o seguinte:

   - Em **Escolha seu modelo de preços**, selecione **Por uso**, **Por nível** e **Escalonado**.

   - Em **Preço**, crie dois níveis de preços escalonados:

|                    | Primeira unidade | Última unidade | Por unidade | Taxa fixa |
| ------------------ | ---------------- | -------------- | ----------- | --------- |
| **Primeiro nível** | 0​               | 100.000        | 0 USD       | 0 USD     |
| **Segundo nível**  | 100.001          | ∞              | 0.001 USD   | 0 USD     |

1. Em **Medidor**, crie um novo medidor para registrar o uso. No exemplo da Hypernian, use o nome do medidor “hypernian_api_tokens.”

1. Clique em **Próximo**.

1. Clique em **Adicionar produto**. Quando você criar assinaturas, especifique os dois preços.

#### API

Primeiro, crie seu [produto](https://docs.stripe.com/api/products.md). Para o exemplo da Hypernian, use o nome `Hypernian tokens`.

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

Em seguida, adicione uma taxa fixa [preço](https://docs.stripe.com/api/prices.md) ao produto com uma taxa licenciada 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"
```

Em seguida, adicione um preço por consumo ao produto com uma taxa escalonada com dois níveis.

Para o primeiro nível, especifique de 0 a 100.000 unidades a 0 USD por unidade. Para o segundo nível, especifique 0 USD por unidade. O primeiro nível tem o preço de 0 USD, pois a taxa fixa inclui as primeiras 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 fim, especifique os IDs de preço quando você [criar uma assinatura](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}}"
```

## Pagamento por consumo

O modelo de pagamento por consumo (também chamado de “cobrança atrasada”) permite monitorar o uso incorrido em um determinado período e cobrar o cliente no final desse período.

Você pode usar qualquer uma das seguintes estratégias de preços:

- **Por unidade**: Cobre o mesmo valor para cada unidade.
- **Por pacote**: Cobre um valor por um pacote ou pacote de unidades ou uso.
- **Preços baseados em volume**: Cobre o item de assinatura no nível que corresponde ao valor de uso no final do período.
- **Preços escalonados**: Cobre pelo uso em cada nível, em vez de aplicar um preço único a todo o uso.

Esse modelo pode fazer com que os clientes acumulem um uso significativo e afetar o status da forma de pagamento no final do mês.

## Queima de crédito

O modelo de consumo de crédito permite coletar pagamento antecipado de produtos e serviços por uso. Os clientes podem usar [créditos de cobrança](https://docs.stripe.com/billing/subscriptions/usage-based/billing-credits.md) para pagar um valor inicial e aplicar seus créditos de cobrança à medida que usam o produto.

Por exemplo, a Hypernian deseja vender um contrato corporativo de grande porte para um cliente de autoatendimento já existente, referente ao novo Modelo Hypernian. O cliente se compromete a pagar 100000 USD antecipadamente pela Hypernian, para receber 120000 USD em créditos de cobrança a serem usados dentro de 1 ano.

#### Dashboard

#### Cobrar pagamento antecipado de um cliente

1. Na página [Faturas](https://dashboard.stripe.com/invoices), clique em **Criar fatura**.
1. Selecione seu cliente no menu suspenso **Cliente**.
1. Selecione a moeda correta no menu suspenso **Moeda**.
1. Em **Itens**, selecione **Adicionar novo item de linha**.
1. Em **Detalhes do item**, faça o seguinte:
   - Para **Item**, insira “Créditos Hypernian”.
   - Em **Preço**, insira “100.000”.
   - Clique em **Salvar**.
1. Clique em **Enviar fatura**.

Depois que o cliente pagar a fatura, você poderá conceder a ele créditos de cobrança.

#### Conceda créditos de cobrança a um cliente

1. Na página [Clientes](https://dashboard.stripe.com/test/customers), selecione o nome do cliente.
1. Na página do cliente, em **Concessões de crédito**, clique no símbolo de mais (**+**).
1. Na página **Nova concessão de crédito**, faça o seguinte:
   - Em **Nome**, insira um nome para sua concessão de crédito.
   - Para **Valor**, especifique o valor da concessão de crédito. No exemplo da Hypernian, insira “120.000.”
   - Em **Data de expiração**, especifique a data, se houver, em que os créditos expiram. No exemplo da Hypernian, selecione **Data específica** e defina uma data 12 meses a partir de agora.
   - Clique em **Criar concessão**.

#### API

Primeiro, crie uma fatura.

```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
```

Em seguida, adicione os créditos de cobrança à fatura.

```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}}
```

Em seguida, finalize a fatura.

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

Depois que o cliente pagar a fatura, você poderá conceder a ele créditos de cobrança.

```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
```