Colecciones de Productos

​

Puntos Clave

• Estructura basada en colecciones: Agrupa productos relacionados (planes, niveles, opciones de precios) bajo una sola colección para una gestión organizada.
• Una colección, muchos productos: Incluye múltiples productos como Starter, Pro, Lifetime, etc., cada uno con su propio modelo de precios.
• Experiencia de pago dinámica: Muestra todos los productos de una colección en una vista de pago, permitiendo a los clientes elegir su plan preferido.
• Control a nivel de comerciante: Habilita, deshabilita y reorganiza productos dentro de cada colección. El primer producto se selecciona automáticamente en el pago.
• Conciencia del ciclo de vida: Permite a los clientes actualizar o disminuir entre productos en la misma colección a través del Portal del Cliente.

​

Creando una Colección de Productos

1

Create the collection

Define la colección con un nombre y una descripción opcional. Sube una imagen para representar visualmente la colección en el checkout.

Campos de la colección:

• Nombre (requerido): Nombre a mostrar para la colección (por ejemplo, “Planes SaaS”, “Niveles de Licencia”)
• Descripción (opcional): Explicación breve mostrada en el pago
• Imagen (opcional): Branding visual para la colección

2

Add products to the collection

Añade productos existentes a tu colección. Los productos pueden organizarse en grupos para lograr una mejor estructura.

Organización de productos:

• Grupos: Organiza opcionalmente productos en grupos nombrados (por ejemplo, “Planes Mensuales”, “Planes Anuales”)
• Productos sin agrupar: Productos sin grupo aparecen a nivel de colección
• Ordenación: Arrastra y suelta para establecer el orden de visualización

Cada producto solo puede pertenecer a una colección. Si un producto ya está en otra colección, tendrás que eliminarlo primero.

3

Configure ordering and visibility

Controla el orden de visualización y la visibilidad de los productos dentro de la colección.Opciones de configuración:

• Estado del producto: Habilita o deshabilita productos individuales dentro de la colección
• Orden de visualización: Arrastra y suelta para establecer la secuencia en la que aparecen los productos en el pago

El primer producto de la colección se preselecciona automáticamente como predeterminado en el checkout. Reordena los productos para cambiar cuál se selecciona por defecto.

​

Pago de la Colección

​

Tipos de Pago

​

Experiencia de Pago de la Colección

1. Todos los productos activos mostrados: Los clientes ven todos los productos habilitados en la colección
2. Primer producto preseleccionado: El primer producto en el orden de la colección se selecciona automáticamente
3. Detalles del producto mostrados: Cada producto muestra su nombre, descripción y precio
4. Selección única: El cliente selecciona un producto para comprar
5. Flujo estándar continúa: Después de la selección, el pago procede con los ajustes de precios y facturación del producto elegido

​

Integración de API

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

// Redirect customer to the checkout
window.location.href = session.url;

​

Integración del Portal del Cliente

​

Acciones de gestión del plan

​

Reglas de upgrade/downgrade

• Las mejoras y degradaciones solo están disponibles entre productos dentro de la misma colección
• Se aplica la prorrata según la configuración de suscripción
• Se envían notificaciones por correo electrónico al negocio en cada upgrade, downgrade o cancelación

​

Configuración de suscripciones

​

Configuración disponible

​

Gestión de colecciones

​

Operaciones del panel

• Crear: Configura nuevas colecciones con productos y grupos
• Actualizar: Modifica el nombre, la descripción, la imagen y la organización de productos
• Reordenar: Arrastra y suelta para cambiar el orden de visualización de los productos
• Habilitar/deshabilitar productos: Controla qué productos aparecen en el checkout
• Eliminar: Elimina una colección (los productos permanecen pero se desvinculan)

​

Mejores prácticas

• Agrupa lógicamente: Organiza los productos por intervalo de facturación (mensual/anual) o por nivel de funciones (starter/pro/enterprise)
• Ordena estratégicamente: Coloca tu plan más popular o recomendado primero, ya que se preseleccionará en el checkout
• Usa nombres claros: Los nombres de producto deben comunicar claramente las diferencias de valor
• Habilita ambas direcciones: Permite tanto upgrades como downgrades para brindar flexibilidad a los clientes
• Ten en cuenta la prorrata: Elige un modo de prorrata que se alinee con tu modelo de negocio
• Prueba exhaustivamente: Verifica los flujos de checkout y cambio de plan en modo de prueba antes de lanzar en vivo