Colecciones de Productos

Product Collections agrupa productos relacionados (por ejemplo, planes Starter, Pro y Enterprise) bajo una misma colección. Muestra todas las opciones en un único checkout, define rutas de mejora o reducción de plan y permite a los clientes cambiar de plan directamente desde el Customer Portal.

Captura de pantalla de la página de pago de la Colección de Productos mostrando varios productos exhibidos

Puntos Clave

Product Collections te permite:

Agrupar productos relacionados (planes, niveles y opciones de precios) para una gestión organizada.
Incluir varios productos, como Starter, Pro y Lifetime, cada uno con su propio modelo de precios.
Mostrar todos los productos en una sola vista de checkout para que los clientes comparen y elijan su plan preferido.
Permitir que los clientes mejoren o reduzcan su plan entre productos de la misma colección mediante el Customer Portal.
Controlar qué productos son visibles, en qué orden aparecen y cuál está preseleccionado en el checkout.

Crear una Product Collection

Crea y administra colecciones desde el dashboard o mediante la API.

Create the collection

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

Captura de pantalla del formulario de creación de Product Collection en el dashboard, con campos para el nombre, la descripción y la carga de imágenes

Campos de la colección:

Name (obligatorio): Nombre visible (por ejemplo, “SaaS Plans”, “License Tiers”).
Description (opcional): Breve explicación que se muestra en el checkout.
Image (opcional): Elemento visual de marca para la colección.

Add products to the collection

Añade productos existentes a tu colección. Organízalos en grupos para conseguir una estructura más clara.

Captura de pantalla de la página de productos de Product Collection, con una lista de productos y la opción de añadirlos a la colección

Organización de productos:

Groups: Organiza opcionalmente los productos en grupos con nombre (por ejemplo, “Monthly Plans”, “Annual Plans”).
Productos sin grupo: Los productos que no tienen un grupo aparecen en el nivel de la colección.
Orden: 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, quítalo primero.

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:

Product status: Activa o desactiva productos individuales dentro de la colección.
Display order: Arrastra y suelta para establecer la secuencia en la que aparecen los productos en el checkout.

El primer producto de la colección se preselecciona automáticamente en el checkout. Reordena los productos para cambiar cuál aparece seleccionado de forma predeterminada.

Checkout de la colección

Las colecciones permiten disfrutar de una experiencia de checkout unificada en la que los clientes pueden ver y seleccionar todos los productos disponibles desde un solo lugar.

Tipos de checkout

Tipo	Descripción	Caso de uso
Collection Checkout	Muestra todos los productos activos de una colección	Selección de planes de suscripción, precios por niveles
Single Product Checkout	Muestra un único producto específico	Compra directa, enlaces promocionales

Experiencia de Collection Checkout

Al usar un Collection Checkout:

Se muestran todos los productos activos de la colección.
El primer producto según el orden de la colección se preselecciona automáticamente.
Cada producto muestra su nombre, descripción y precio.
El cliente selecciona un producto para comprarlo.
El checkout continúa con los precios y la configuración de facturación del producto elegido.

Captura de pantalla de la página de checkout de Product Collection, con varios productos mostrados

El checkout de una colección es ideal para empresas de suscripción cuyos clientes comparan planes en paralelo antes de comprar.

Integración con la API

Crea una sesión de checkout para una colección:

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'
});

window.location.href = session.checkout_url;

Al usar product_collection_id, no se pueden aplicar códigos de descuento previamente al crear la sesión. Los clientes aún pueden introducir códigos durante el checkout si esta opción está habilitada.

Integración con Customer Portal

Los clientes pueden mejorar o reducir su plan entre productos de la misma colección directamente desde el Customer Portal.

¿Ya tienes productos de suscripción? Añádelos a una Product Collection para habilitar los flujos de mejora o reducción de plan en el Customer Portal. No es necesario volver a crear tus productos.

Acciones de gestión del plan

Acción	Descripción	Control del merchant
View Current Plan	Muestra el nombre, el precio y la fecha de renovación del producto actual.	Siempre disponible.
Upgrade Plan	Cambia a un producto de nivel superior de la misma colección.	Configurable (deshabilitado de forma predeterminada).
Downgrade Plan	Cambia a un producto de nivel inferior de la misma colección.	Configurable (deshabilitado de forma predeterminada).
Cancel	Cancela la suscripción por completo.	Siempre disponible.

Reglas de mejora y reducción de plan

Las mejoras y reducciones de plan solo están disponibles entre productos de la misma colección.
La prorrata de los cambios de plan en el Customer Portal sigue el comportamiento predeterminado de mejora y reducción de plan en Settings → Subscriptions, y cada colección puede sustituir esos valores predeterminados. Los cambios de plan realizados mediante la Change Plan API utilizan el proration_billing_mode enviado con la solicitud.
Se envían notificaciones por email a la empresa en cada mejora, reducción o cancelación.

Los clientes no pueden cambiar a productos que estén fuera de su colección actual. Crea colecciones independientes para líneas de productos distintas.

Configuración de suscripciones

Configura cómo funcionan las suscripciones y los cambios de plan en tu empresa desde Settings → Subscriptions en tu dashboard.

Configuración disponible

Configuración	Descripción	Valor predeterminado
Allow Multiple Subscriptions	Los clientes pueden tener más de una suscripción activa al mismo tiempo.	Habilitado
Allow Subscription Updates	Los clientes pueden mejorar o reducir sus suscripciones existentes en cualquier momento mediante Customer Portal.	Deshabilitado
Allow Immediate Cancellation	Los clientes pueden finalizar su suscripción y perder el acceso de inmediato.	Habilitado
Allow Cancellation at Next Billing Date	Los clientes pueden cancelar al final del periodo que ya han pagado.	Habilitado
Allow Subscription Pause	Los clientes pueden pausar y reanudar sus propias suscripciones desde el Customer Portal.	Deshabilitado
Bill Usage at Pause	Una suscripción basada en el uso que se pausa se factura por el uso adeudado en el momento de la pausa, en lugar de trasladar el uso a la siguiente factura habitual.	Habilitado
Prevent Trial Misuse	Los clientes que ya han canjeado una prueba pasan a una compra de pago sin prueba, en lugar de recibir una prueba nueva.	Deshabilitado
Payment Method Reminder	Días antes de que comience la facturación en los que se envía un email al cliente de una suscripción Card-Optional at Zero Price para añadir un método de pago (de 1 a 30 días).	3 días

Los cambios de plan mediante Customer Portal están deshabilitados de forma predeterminada. Habilita “Allow Subscription Updates” en Settings → Subscriptions para permitir que los clientes mejoren o reduzcan su plan entre productos de la misma colección.

Las dos configuraciones de cancelación son independientes. Puedes permitir que los clientes mantengan el acceso durante el periodo que ya han pagado y reservar la cancelación inmediata para ti, o hacer lo contrario. Al desactivar una opción, esta se oculta en el Customer Portal y se rechazan las solicitudes correspondientes mediante la API de Customer Portal. Las cancelaciones realizadas por tu propio merchant no se ven afectadas. Consulta Cancelling a Subscription.

“Allow Subscription Pause” solo controla el Customer Portal: puedes pausar y reanudar desde el dashboard o la API, independientemente de cómo esté configurada esta opción. “Bill Usage at Pause” solo se aplica a suscripciones basadas en el uso y se registra por ciclo de facturación, por lo que cambiarla a mitad del ciclo no modifica cómo se liquida el ciclo en curso. Consulta Pausing and Resuming Subscriptions.

Para obtener información sobre cómo se comparan y registran los canjes de pruebas, consulta Preventing Trial Misuse.

“Payment Method Reminder” solo es relevante para suscripciones que tienen habilitada la opción Card-Optional at Zero Price; no afecta a las suscripciones que ya requieren una tarjeta. Consulta What Happens Without a Card para ver la secuencia completa, incluido lo que ocurre si se ignora el recordatorio.

Subscription Plan Changes

Obtén más información sobre los modos de prorrata y el comportamiento de los cambios de plan.

Gestionar colecciones

Gestiona las colecciones mediante el dashboard o mediante programación a través de la API.

Operaciones desde el dashboard

Create: Configura nuevas colecciones con productos y grupos.
Update: Modifica el nombre, la descripción, la imagen y la organización de los productos.
Reorder: Arrastra y suelta para cambiar el orden de visualización de los productos.
Enable/Disable products: Controla qué productos aparecen en el checkout.
Archive: Oculta una colección sin eliminarla permanentemente (puedes restaurarla más adelante).

Captura de pantalla del dashboard de Product Collection, con las operaciones de gestión de colecciones

Gestión mediante la API

Utiliza los siguientes endpoints para crear, actualizar, consultar, archivar y organizar Product Collections mediante programación, incluida la gestión de grupos y productos anidados.

Listing Product Collections

Obtén todas las Product Collections asociadas a tu cuenta mediante una solicitud GET al endpoint /product-collections. Admite paginación, filtrado por marca e inclusión de colecciones archivadas.

List Product Collections API

Consulta la estructura detallada de la solicitud y la respuesta en la documentación de la API List Product Collections.

Creating a Product Collection

Crea una Product Collection nueva enviando una solicitud POST al endpoint /product-collections con datos como el nombre, la descripción y la marca.

Create Product Collection API

Consulta la estructura detallada de la solicitud y la respuesta en la documentación de la API Create Product Collection.

Retrieving a Product Collection

Obtén información detallada sobre una Product Collection específica —incluidos sus grupos y productos— mediante una solicitud GET al endpoint /product-collections/{id}.

Get Product Collection API

Consulta la estructura detallada de la solicitud y la respuesta en la documentación de la API Get Product Collection.

Updating a Product Collection

Modifica los datos de una Product Collection (nombre, descripción, marca, etc.) enviando una solicitud PATCH al endpoint /product-collections/{id}.

Update Product Collection API

Consulta la estructura detallada de la solicitud y la respuesta en la documentación de la API Update Product Collection.

Uploading Collection Images

Asocia una imagen a una colección subiéndola mediante una URL prefirmada. Solicita una URL de carga al endpoint /product-collections/{id}/images y, a continuación, PUT la imagen a la URL devuelta en un plazo de 60 segundos.

La URL prefirmada caduca en 60 segundos, por lo que la imagen debe cargarse dentro de ese plazo.

Update Collection Images API

Consulta la estructura detallada de la solicitud y la respuesta en la documentación de la API Update Collection Images.

Archiving a Product Collection

Archiva una colección enviando una solicitud DELETE al endpoint /product-collections/{id}. Esto oculta la colección para nuevos usos, pero no la elimina permanentemente.

Archive Product Collection API

Consulta la estructura detallada de la solicitud y la respuesta en la documentación de la API Archive Product Collection.

Unarchiving a Product Collection

Restaura una colección archivada enviando una solicitud POST al endpoint /product-collections/{id}/unarchive.

Unarchive Product Collection API

Consulta la estructura detallada de la solicitud y la respuesta en la documentación de la API Unarchive Product Collection.

Managing Groups within a Collection

Los grupos te permiten organizar productos dentro de una colección (por ejemplo, “Monthly Plans” frente a “Annual Plans”). Utiliza los endpoints de grupos para añadir, actualizar o eliminar grupos dentro de una colección.

Crear un grupo: POST /product-collections/{id}/groups
Actualizar un grupo: PATCH /product-collections/{id}/groups/{group_id}
Eliminar un grupo: DELETE /product-collections/{id}/groups/{group_id}

Create Group

Añade un grupo nuevo a una Product Collection.

Update Group

Modifica el nombre o los atributos de un grupo.

Delete Group

Elimina un grupo de una colección.

Managing Products within a Group

Gestiona los productos individuales dentro de un grupo: añade productos nuevos, actualiza los existentes (por ejemplo, su orden de visualización) o elimínalos por completo.

Añadir productos a un grupo: POST /product-collections/{id}/groups/{group_id}/items
Actualizar un elemento del grupo: PATCH /product-collections/{id}/groups/{group_id}/items/{item_id}
Eliminar un elemento del grupo: DELETE /product-collections/{id}/groups/{group_id}/items/{item_id}

Add Products to Group

Añade uno o varios productos a un grupo dentro de una colección.

Update Group Item

Actualiza un producto dentro de un grupo.

Delete Group Item

Elimina un producto de un grupo.

Prácticas recomendadas

Agrupa de forma lógica: Organiza los productos por intervalo de facturación (mensual/anual) o nivel de funcionalidades (starter/pro/enterprise).
Ordena estratégicamente: Coloca primero el plan más popular o recomendado, ya que se preseleccionará en el checkout.
Usa nombres claros: Los nombres de los productos deben comunicar claramente las diferencias de valor.
Habilita ambas direcciones: Permite tanto las mejoras como las reducciones de plan para ofrecer flexibilidad a los clientes.
Considera la prorrata: Elige un modo de prorrata que se ajuste a tu modelo de negocio.
Prueba exhaustivamente: Verifica los flujos de checkout y de cambio de plan en modo de prueba antes de entrar en producción.

Products

Crea productos únicos, de suscripción o basados en el uso para añadirlos a las colecciones.

Checkout

Muestra los productos de la colección en una experiencia de checkout unificada.

Customer Portal

Permite que los clientes mejoren o degraden su plan dentro de la misma colección.

Subscriptions

Gestiona planes recurrentes con prorrateo y cambios de plan.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Puntos Clave

Crear una Product Collection