¿Qué es un Producto?
Un producto representa qué vendes: un bien o servicio de tu catálogo (por ejemplo “OnePay Pro” o “Asientos adicionales”). El producto describe la oferta —su nombre, descripción y características de marketing— pero no incluye el monto. El monto vive en los precios asociados al producto. Esta separación te permite tener un mismo producto con varios precios (mensual, anual, por moneda o por región) sin duplicar la oferta.¿Cuándo usar Productos?
Usa productos cuando quieras organizar tu catálogo de cobros recurrentes de forma reutilizable. Por ejemplo:- Catálogos con varios niveles (básico, pro, empresarial)
- Un mismo servicio cobrado en varias monedas o frecuencias
- Productos con características de marketing que muestras en el checkout
Objeto producto
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único (UUID) del producto. |
object | string | Siempre product. |
name | string | Nombre del producto. |
description | string | null | Descripción del producto. |
active | boolean | false cuando el producto está archivado. |
internal_id | string | null | Tu identificador interno. |
unit_label | string | null | Etiqueta de la unidad (ej. asientos). |
tax_rate | number | null | Porcentaje de IVA (0-100). |
default_price | string | null | ID del precio por defecto. |
marketing_features | array | Características de marketing (hasta 15), cada una {name}. |
metadata | object | null | Datos adicionales de tu aplicación. |
prices | array | Precios activos del producto (solo en el detalle). |
created_at | string | Fecha de creación (ISO 8601). |
updated_at | string | Fecha de última actualización (ISO 8601). |
Endpoints
Listar productos
Obtén el listado paginado de tus productos activos.
Crear producto
Registra un nuevo producto en tu catálogo.
Detalle del producto
Consulta un producto con sus precios activos.
Actualizar producto
Modifica los datos de un producto existente.
Archivar producto
Archiva un producto y sus precios sin borrarlos.