Precios y Modelos de Fijación de Precios
Cada producto puede tener múltiples precios, permitiendo variantes por moneda, intervalo de cobro o modelo de fijación de precios. Los precios son en gran parte inmutables después de su creación — solo el nombre y los metadatos pueden modificarse. Para cambiar valores, desactive el precio anterior y cree uno nuevo.
Campos del Precio
| Campo | Descripción |
|---|---|
| Nombre | Nombre de la variante (ej: "Standard", "Pro") |
| Moneda | Código ISO 4217 (predeterminado: BRL) |
| Activo | Si el precio está disponible para uso |
| Billing Scheme | Modelo de fijación de precios |
| Valor unitario | Precio por unidad, en BRL (hasta 4 decimales) |
| Intervalo de recurrencia | month o year |
| Conteo de intervalos | Repeticiones (ej: 3 meses) |
| Tipo de uso | licensed (fija) o metered (medida) |
Valores Monetarios — Subcents
Los precios son números decimales en BRL y admiten hasta 4 decimales, lo que permite precios unitarios fraccionados:
| Valor | Significado |
|---|---|
100 | R$ 100,00 |
50.5 | R$ 50,50 |
0.999 | R$ 0,999 |
Importante: los precios son el único lugar donde se conservan los 4 decimales. Los demás valores monetarios (factura, pago, crédito) se redondean a 2 decimales.
Modelos de Fijación de Precios
1. Por Unidad (per_unit)
El modelo más simple: precio fijo por unidad.
Precio: R$ 5,00/usuario/mes
10 usuarios = R$ 50,00/mes
2. Escalonado — Graduated (tiered + graduated)
Cada tramo tiene un precio diferente, y solo las unidades dentro de cada tramo se cobran a ese valor.
Tramo 1: 1-10 unidades → R$ 10,00/un
Tramo 2: 11-50 unidades → R$ 8,00/un
Tramo 3: 51+ unidades → R$ 5,00/un
Para 25 unidades:
(10 × R$ 10,00) + (15 × R$ 8,00) = R$ 220,00
3. Volumen (tiered + volume)
Cuando el cliente alcanza un tramo, todas las unidades se cobran al valor de ese tramo.
Tramo 1: 1-10 unidades → R$ 10,00/un
Tramo 2: 11-50 unidades → R$ 8,00/un
Tramo 3: 51+ unidades → R$ 5,00/un
Para 25 unidades:
25 × R$ 8,00 = R$ 200,00 (todas en el tramo 2)
4. Paquete (package)
Precio fijo para un paquete de ítems definido.
Configuración de Tramos (Tiers)
Cada tramo define:
| Campo | Descripción |
|---|---|
up_to | Límite superior del tramo (null = ilimitado, tramo final) |
unit_amount | Precio por unidad en este tramo |
flat_amount | Valor fijo adicional por tramo (predeterminado: 0) |
Tipo de Uso
| Tipo | Descripción |
|---|---|
licensed | Cantidad fija definida en la suscripción |
metered | Cantidad medida y reportada a lo largo del ciclo |