# Estabeleça preços escalonados Estabeleça preços escalonados para suas assinaturas. Os preços podem representar níveis, permitindo que o custo unitário varie de acordo com a quantidade ou o uso. Utilize níveis se precisar de um plano de preços não linear quando `quantity` ou [uso](https://docs.stripe.com/api/billing/meter-event.md) mudar. Para criar [modelos de planos de preços com base no uso](https://docs.stripe.com/subscriptions/pricing-models/usage-based-pricing.md), você pode combinar preços escalonados com taxas fixas. Por exemplo, imagine uma empresa chamada [Typographic](https://typographic.io/) que deseja oferecer preços mais baixos para clientes que usam mais fontes por mês. Os seguintes modelos de preços escalonados mostram duas formas diferentes de ajustar os planos de preços conforme o uso aumenta: [plano de preços com base no volume](https://docs.stripe.com/subscriptions/pricing-models/tiered-pricing.md#volume-based-pricing) e [plano de preços escalonados](https://docs.stripe.com/subscriptions/pricing-models/tiered-pricing.md#graduated-pricing). Para ilustrar essas abordagens de preços escalonados, usaremos os seguintes níveis: | | Número de fontes | Preço por nível | | ------------------ | ---------------- | --------------- | | **Primeiro nível** | 1-5 | 7 USD | | **Segundo nível** | 6-10 | 6.5 USD | | **Terceiro nível** | 11+ | 6 USD | ## Plano de preços baseado em volume Com o preço baseado em volume, o item de assinatura fatura no nível correspondente à quantidade de uso no final do período. Toda a `quantity` (ou `usage`) é multiplicada pelo custo unitário do nível. Como o preço do nível se aplica ao valor total de `quantity` (ou `usage`), o total pode diminuir no cálculo do custo final. Por exemplo, a um cliente com 5 fontes, é cobrado 35 USD (5 × 7 USD) em novembro. Se ele usar 6 fontes em dezembro, a Typographic faturará todas as fontes na tarifa de `6-10`. Em dezembro, a Typographic cobrará 39 USD (6 × 6.5 USD). | Quantidade e uso no final do período | Custo unitário | Custo mensal 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. Acesse o [catálogo de produtos](https://dashboard.stripe.com/products). 1. Clique em **+ Criar produto**. 1. Insira um **Nome** para o produto. 1. (Opcional) Adicione uma **Descrição**. A descrição 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 seguida, crie o preço mensal do produto: 1. Clique em **Mais opções de planos de preços**. 1. Selecione **Recorrente**. 1. Em **Escolher modelo de preços**, selecione **Preços escalonados** e **Volume**. 1. Em **Preço**, crie três níveis: | | Primeira unidade | Última unidade | Por unidade | Taxa fixa | | -------------- | ---------------- | -------------- | ----------- | --------- | | Primeiro nível | 1 | 5​ | 7 USD | 0 USD | | Segundo nível | 6​ | 10​ | 6.5 USD | 0 USD | | Terceiro nível | ​11 | ∞ | 6 USD | 0 USD | 1. Para **Período de cobrança**, selecione **Mensal**. 1. Clique em **Adicionar produto** para salvar o produto e o preço. Só é possível editar o produto e o preço até criar uma assinatura com eles. #### API Crie os níveis para corresponder ao exemplo e defina o valor de `tiers_mode` como `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" ``` ## Preços escalonados O plano de preços escalonados cobra o valor correspondente ao uso em cada nível, em vez de aplicar um preço único para o uso total. A `quantity` é multiplicada pelo valor de cada nível e os totais de cada nível são somados. Por exemplo, 5 fontes resultam na mesma cobrança que o plano de preços por volume: 35 USD no total, ou 7 USD por fonte. Isso muda conforme o uso excede o primeiro nível. A Typographic cobra de um cliente com mais de 5 fontes 7 USD por fonte para as primeiras 5 fontes, depois 6.5 USD para as fontes de 6 a 10 e 6 USD para fontes adicionais. Ela cobra de um cliente com 6 fontes 41.5 USD, sendo 35 USD para as primeiras 5 fontes e 6.5 USD para a 6ª fonte. | Quantidade e uso no final do período | Total de níveis de preços escalonados | | ------------------------------------ | ------------------------------------- | | 1 | 7 USD | | 5​ | 35 USD | | 6​ | 41.5 USD | | 20 | 127.5 USD | | 25 | 157.5 USD | #### Dashboard 1. Acesse o [catálogo de produtos](https://dashboard.stripe.com/products). 1. Clique em **+ Criar produto**. 1. Insira um **Nome** para o produto. 1. (Opcional) Adicione uma **Descrição**. A descrição 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 seguida, crie o preço mensal do produto: 1. Clique em **Mais opções de planos de preços**. 1. Selecione **Recorrente**. 1. Em **Escolher modelo de preços**, selecione **Preços escalonados** e **Escalonados**. 1. Em **Preço**, crie três níveis: | | Primeira unidade | Última unidade | Por unidade | Taxa fixa | | -------------- | ---------------- | -------------- | ----------- | --------- | | Primeiro nível | 1 | 5​ | 7 USD | 0 USD | | Segundo nível | 6​ | 10​ | 6.5 USD | 0 USD | | Terceiro nível | ​11 | ∞ | 6 USD | 0 USD | 1. Para o **Período de cobrança**, selecione **Mensal**. 1. Clique em **Adicionar produto** para salvar o produto e o preço. Só é possível editar o produto e o preço até criar uma assinatura com eles. #### API Crie os níveis conforme o exemplo e defina o valor de `tiers_mode` como `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" ``` ## Adicionar taxa fixa Você pode configurar uma tarifa fixa (`flat_amount`) a ser incluída na *fatura*. Essa configuração funciona tanto para modelos de precificação por volume quanto para modelos escalonados. Por exemplo, é possível aplicar uma tarifa fixa adicional que aumenta se o cliente exceder determinados limites de uso: | Nível | Valor (custo unitário) | Taxa fixa | | ------------------ | -------------------------- | --------------------------- | | 1-5 (`up_to=5`) | 5 USD (`unit_amount=500`) | 10 USD (`flat_amount=1000`) | | 6-10 (`up_to=10`) | 4 USD (`unit_amount=400`) | 20 USD (`flat_amount=2000`) | | 10-15 (`up_to=15`) | 3 USD (`unit_amount=300`) | 30 USD (`flat_amount=3000`) | | 15-20 (`up_to=20`) | 2 USD (`unit_amount=200`) | 40 USD (`flat_amount=4000`) | | 20+ (`up_to=inf`) | 1 USD (`unit_amount=100`) | 50 USD (`flat_amount=5000`) | #### Exemplo de preço fixo estabelecido por volume Se `quantity` for `12` e `tiers_mode=volume`, o valor total cobrado será: 12 × 3 USD + 30 USD = 66 USD #### Exemplo de taxa fixa com escalonamento Se `quantity` for `12` e `tiers_mode=graduated`, o valor total cobrado será: (5 × 5 USD + 10 USD) + (5 × 4 USD + 20 USD) + (2 × 3 USD + 30 USD) = 111 USD Um nível pode ter um `unit_amount` ou um `flat_amount`, ou ambos, mas deve ter pelo menos um dos dois. Se `quantity` é`0`, o valor total é 10 USD, independentemente do modelo de preços escalonados usado. A Stripe sempre cobra o primeiro nível de taxa fixa quando`quantity=0`. Para cobrar `0` quando não houver uso, configure um nível `up_to=1` com `unit_amount` igual à taxa fixa e omita `flat_amount`.