Skip to main content

​
¿Qué es un Precio?

Un precio (price) responde a la pregunta “cuánto y cada cuánto”. Siempre pertenece a un producto y describe el monto, la moneda y la frecuencia con la que se cobra a tus clientes. Un producto (el “qué vendes”) puede tener varios precios: por ejemplo, el mismo producto “Plan Pro” con un precio mensual y otro anual, o con distintas monedas. 
Producto "Plan Pro"
  ├── Precio "Mensual"  → COP 79.900 / mes
  ├── Precio "Anual"    → COP 799.000 / año
  └── Precio "USD"      → USD 19,90 / mes
Los precios son inmutables una vez creados. No puedes cambiar el monto, la moneda ni la recurrencia de un precio existente. Para modificar un precio, crea uno nuevo y archiva el anterior con Archivar precio.Usa lookup_key para no atarte al id: asígnale una clave estable (por ejemplo pro_monthly) y, cuando crees el precio de reemplazo, envía transfer_lookup_key: true para mover esa clave al nuevo precio de forma atómica. Tu código sigue apuntando al mismo lookup_key sin cambios.

​
Objeto price

Cada precio expone los siguientes campos:
  • unit_amount_in_cents: el monto a cobrar, expresado en centavos.
  • currency: la moneda ISO del cobro (por ejemplo COP).
  • recurring: la frecuencia (interval, interval_count, total_cycles, trial_period_days).
  • active: indica si el precio está vigente. Un precio archivado tiene active: false.

​
Endpoints

Listar precios

Consulta los precios del catálogo de tu empresa con filtros y paginación.

Crear precio

Crea un nuevo precio recurrente para uno de tus productos.

Detalle del precio

Obtiene los datos de un precio específico por su ID.

Archivar precio

Archiva un precio (active=false) sin afectar las suscripciones vigentes.