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 (subcents) | Precio por unidad en subcents (÷10.000 para obtener reales) |
| 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 utilizan subcents con precisión de 4 decimales:
| Valor en subcents | Valor en BRL |
|---|---|
| 1.000.000 | R$ 100,00 |
| 500.000 | R$ 50,00 |
| 9.990 | R$ 0,999 |
Importante: Solo los modelos Price, SubscriptionItem, ProposalItem y PlanChange usan subcents (÷10.000). Todos los demás campos monetarios (Invoice, Payment, Credit, etc.) usan cents (÷100).
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_subcents | Precio por unidad en este tramo |
flat_amount_subcents | 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 |