Productos y características

Define lo que vendes. Crea productos con una o más variantes, adjunta características reutilizables para control de acceso basado en permisos.

Proyecta Commerce usa tres conceptos: productos, variantes y características.

• Producto — lo que vendes (p. ej., “Plan Pro”, “Camiseta”, “Consultoría Estratégica”)
• Variante — un nivel de precio o configuración de un producto (p. ej., “Pro Mensual $29”, “Pro Anual $290”, “Camiseta – Talla Grande”)
• Característica — una clave de permiso reutilizable que tu app verifica en tiempo de ejecución (p. ej., pro_features, unlimited_projects, api_access)

Un producto puede tener múltiples variantes. Un producto también tiene uno o más recursos adjuntos — generalmente características — que otorgan acceso cuando un cliente se suscribe.

Dos formas de modelar lo que vendes

Commerce se integra con el resto de la plataforma, así que hay dos formas de representar “lo que vendes” — y Proyecta elige la correcta por ti:

• Productos nativos de Commerce — suscripciones, planes, actualizaciones únicas y características/permisos. Se definen directamente en Admin > Commerce > Products. Este es el modelo que describe el resto de esta página.
• Catálogo de tienda respaldado por contenido — artículos con fotos, precios y descripciones que un administrador edita día a día. Estos viven en el CMS como una colección vendible: cada entrada es el producto. Cuando se publica una entrada, Proyecta automáticamente la integra en Commerce como un producto real y comprable — creando el producto y su variante con precio, y copiando el precio directamente desde el campo de contenido. La tienda muestra el precio del contenido y el checkout cobra la variante vinculada; como comparten una sola fuente, nunca pueden divergir. Administras estos elementos como contenido (en el Admin de tu app, en el builder o en tu sitio publicado), no en Commerce > Products. Consulta Gestión de Contenido.

Un catálogo simple que no acepta pagos con tarjeta — un menú de solo consulta, o una tienda cuyo botón de “comprar” abre un enlace de pedido por WhatsApp — es simplemente contenido ordinario — una colección de catálogo ordinaria, sin integración con Commerce. El checkout con tarjeta es lo que hace que una colección sea vendible.

Crear un producto

En Admin > Commerce > Products, haz clic en Create product (o pídele a la IA: "Crea un plan Pro a $29/mes y un plan Business a $99/mes."). Cada producto necesita:

• Un nombre de visualización (p. ej., “Pro”)
• Al menos una variante

Variantes

Cada variante tiene su propio precio:

Campo	Notas
name	Etiqueta de visualización para la variante (“Monthly”, “Annual”, “Large”)
currency	Código ISO de tres letras — USD, EUR, GBP, JPY, BRL, MXN, INR… (más de 130 compatibles)
unit_amount	Precio en la unidad monetaria más pequeña (centavos). 2900 = $29.00
recurring	Opcional — { interval: 'week' | 'month' | 'year' }. Omite para precios de pago único. La facturación diaria no está soportada actualmente.
is_default	Aceptado pero no implementado aún — la selección de variante predeterminada no está disponible actualmente.
media	Adjunta imágenes o videos por ID de archivo CDN (consulta Archivos)

El precio es inmutable. Una vez que se crea una variante, su precio no puede modificarse — en su lugar, crea una nueva variante. Esto protege a los suscriptores existentes de cambios de precio accidentales.

Características (permisos)

Las características son el elemento primitivo de control de acceso. Crea una característica una vez en Admin > Commerce > Products y luego adjúntala a uno o más productos. Cada característica tiene un nombre, una descripción opcional y una clave — letras minúsculas, números y guiones bajos (p. ej., pro_features) — que es lo que verifica tu app.

Cuando creas un producto, adjuntas características a través de “recursos”. Los clientes que se suscriben a un producto obtienen acceso a todas las características adjuntas a él.

Luego, en tu app, restringe el acceso usando esa clave:

const { hasAccess, isLoading } = useEntitlement('pro_features');

if (isLoading) return <Spinner />;
if (!hasAccess) return <UpgradePrompt />;
return <ProOnlyThing />;

La verificación se ejecuta del lado del servidor contra la sesión autenticada, por lo que no puede ser falsificada desde el navegador. Consulta Integrar Commerce en mi App para ver el patrón completo.

Nota: Siempre restringe el acceso usando la clave de la característica — el slug derivado del nombre de la característica (p. ej., pro_features) — no el ID interno de la característica.

Así es como restringes páginas, endpoints de API o funcionalidades exclusivas para usuarios Pro en el código de tu app.

Formas comunes de productos

Suscripciones SaaS

Create products: Free ($0/month), Pro ($29/month, $290/year), Business ($99/month, $990/year).
Attach a 'pro_features' feature to Pro and Business so I can gate access in my code.

Productos físicos

Create a T-shirt product with three variants: Small, Medium, Large at $25 each.

Productos digitales

Create a course product with a single one-time variant at $149.

Donaciones

Create a donation product with three variants: $25, $50, $100 — all one-time.

Inventario

Proyecta Commerce no lleva un seguimiento de inventario para productos físicos actualmente. Si vendes artículos en stock, administra los conteos de existencias en la base de datos de tu app y verifícalos en tu flujo de checkout.

Próximamente

• Personalización de campos en checkout — recopila información adicional de los compradores
• Precios a elección del comprador
• Seguimiento de inventario integrado para productos físicos