Preços e Modelos de Precificação

Cada produto pode ter múltiplos preços, permitindo variantes por moeda, intervalo de cobrança ou modelo de precificação. Os preços são em grande parte imutáveis após criação — apenas nome e metadados podem ser alterados. Para mudar valores, desative o preço antigo e crie um novo.

Campos do Preço

Campo	Descrição
Nome	Nome da variante (ex: "Standard", "Pro")
Moeda	Código ISO 4217 (padrão: BRL)
Ativo	Se o preço está disponível para uso
Billing Scheme	Modelo de precificação
Valor unitário	Preço por unidade, em reais (até 4 casas decimais)
Intervalo de recorrência	month ou year
Contagem de intervalos	Repetições (ex: 3 meses)
Tipo de uso	licensed (fixa) ou metered (medida)

Valores Monetários

Preços são números decimais em reais (BRL) e aceitam até 4 casas decimais, o que permite preços unitários fracionados:

Valor	Significado
100	R$ 100,00
50.5	R$ 50,50
0.999	R$ 0,999

Importante: preços são o único lugar onde as 4 casas decimais são preservadas. Os demais valores monetários (fatura, pagamento, crédito) são arredondados para 2 casas.

Modelos de Precificação

1. Por Unidade (per_unit)

O modelo mais simples: preço fixo por unidade.

Preço: R$ 5,00/usuário/mês
10 usuários = R$ 50,00/mês

2. Escalonado — Graduated (tiered + graduated)

Cada faixa tem um preço diferente, e apenas as unidades dentro de cada faixa são cobradas naquele valor.

Faixa 1: 1-10 unidades → R$ 10,00/un
Faixa 2: 11-50 unidades → R$ 8,00/un
Faixa 3: 51+ unidades → R$ 5,00/un

Para 25 unidades:
  (10 × R$ 10,00) + (15 × R$ 8,00) = R$ 220,00

3. Volume (tiered + volume)

Quando o cliente atinge uma faixa, todas as unidades são cobradas pelo valor daquela faixa.

Faixa 1: 1-10 unidades → R$ 10,00/un
Faixa 2: 11-50 unidades → R$ 8,00/un
Faixa 3: 51+ unidades → R$ 5,00/un

Para 25 unidades:
  25 × R$ 8,00 = R$ 200,00 (todas na faixa 2)

4. Pacote (package)

Preço fixo para um pacote de itens definido.

Configuração de Faixas (Tiers)

Cada faixa define:

Campo	Descrição
up_to	Limite superior da faixa (null = ilimitado, faixa final)
unit_amount	Preço por unidade nesta faixa
flat_amount	Valor fixo adicional por faixa (padrão: 0)

Tipo de Uso

Tipo	Descrição
licensed	Quantidade fixa definida na assinatura
metered	Quantidade medida e reportada ao longo do ciclo