> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onepay.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Define cuánto y cada cuánto cobras dentro de un producto.

## ¿Qué es un Precio?

Un precio (`price`) responde a la pregunta "cuánto y cada cuánto". Siempre pertenece a un [producto](/client/products/index) 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
```

<Note>
  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](/client/prices/delete).

  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.
</Note>

## 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

<CardGroup cols={2}>
  <Card title="Listar precios" icon="list" href="/client/prices/list">
    Consulta los precios del catálogo de tu empresa con filtros y paginación.
  </Card>

  <Card title="Crear precio" icon="plus" href="/client/prices/create">
    Crea un nuevo precio recurrente para uno de tus productos.
  </Card>

  <Card title="Detalle del precio" icon="eye" href="/client/prices/detail">
    Obtiene los datos de un precio específico por su ID.
  </Card>

  <Card title="Archivar precio" icon="trash" href="/client/prices/delete">
    Archiva un precio (active=false) sin afectar las suscripciones vigentes.
  </Card>
</CardGroup>