Colecciones de Productos

Agrupa productos relacionados para experiencias de pago unificadas, selección de planes y rutas de actualización/diminuación sin problemas dentro del Portal del Cliente.

Las Colecciones de Producto te permiten agrupar productos relacionados (por ejemplo, los planes Starter, Pro y Enterprise) bajo un mismo paraguas. Muestra todas las opciones en un único checkout, define rutas de upgrade/downgrade y ofrece a los clientes la flexibilidad de cambiar de plan directamente desde el Portal del Cliente.

​

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

Las Colecciones de Productos se crean y gestionan desde el panel de control o a través de API. Cada colección actúa como un contenedor para productos relacionados.

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

Las colecciones permiten una experiencia de pago unificada donde los clientes pueden ver y seleccionar todos los productos disponibles en un solo lugar.

​

Tipos de Pago

Tipo	Descripción	Caso de Uso
Pago de Colección	Muestra todos los productos activos dentro de una colección	Selección de plan de suscripción, precios en capas
Pago de Producto Único	Muestra solo un producto específico	Compra directa, enlaces promocionales

​

Experiencia de Pago de la Colección

Al usar un pago de 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

El checkout de colección es ideal para negocios de suscripción donde quieres que los clientes comparen planes lado a lado antes de comprar.

​

Integración de API

Crea una sesión de pago 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'
});

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

Cuando uses product_collection_id, no se pueden aplicar códigos de descuento al crear la sesión. Los clientes aún pueden introducir códigos de descuento durante el checkout si están habilitados.

​

Integración del Portal del Cliente

Los clientes pueden actualizar o disminuir entre productos dentro de la misma colección directamente desde el Portal del Cliente.

¿Ya tienes productos de suscripción? Simplemente añádelos a una Colección de Producto para habilitar los flujos de upgrade/downgrade en el Portal del Cliente. No es necesario volver a crear tus productos.

​

Acciones de gestión del plan

Acción	Descripción	Control del comerciante
Ver plan actual	Muestra el nombre del producto, el precio y la fecha de renovación actuales	Siempre disponible
Actualizar plan	Cambia a un producto de nivel superior dentro de la misma colección	Configurable (predeterminado: permitido)
Degradar plan	Cambia a un producto de nivel inferior dentro de la misma colección	Configurable (predeterminado: permitido)
Cancelar	Cancela la suscripción por completo	Siempre disponible

​

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

Los clientes no pueden cambiar a productos fuera de su colección actual. Crea colecciones separadas para líneas de producto distintas.

​

Configuración de suscripciones

Configura cómo funcionan las suscripciones y los cambios de plan en tu negocio desde Configuración → Suscripciones en tu panel de control.

​

Configuración disponible

Setting	Description	Default
Permitir múltiples suscripciones	Los clientes pueden tener más de una suscripción activa al mismo tiempo	Habilitado
Permitir actualizaciones de suscripciones	Los clientes pueden mejorar o reducir sus suscripciones existentes en cualquier momento mediante Customer Portal	Deshabilitado
Prevenir el uso indebido de pruebas	Los clientes que ya hayan canjeado una prueba pasan a una compra de pago sin prueba en lugar de recibir una prueba nueva	Deshabilitado

Los cambios de plan a través del Portal del Cliente están deshabilitados por defecto. Habilita “Permitir Actualizaciones de Suscripción” en Configuración → Suscripciones para permitir a los clientes actualizar o degradar entre productos en la misma colección.

Para obtener más información sobre cómo se relacionan y registran los canjes de pruebas, consulta Prevenir el uso indebido de pruebas.

Subscription Plan Changes

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

​

Gestión de colecciones

Las colecciones de productos se pueden gestionar mediante el panel de Dodo Payments o mediante programación a través de API. La API proporciona control total sobre la creación, actualización, carga de imágenes y archivado de colecciones, así como sobre la gestión de grupos anidados y productos.

​

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 los 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
• Archivar: Oculta una colección sin eliminarla permanentemente (se puede desarchivar más adelante)

​

Gestión mediante API

Los siguientes endpoints permiten crear, actualizar, consultar, archivar y organizar colecciones de productos mediante programación, incluida la gestión de grupos anidados y de los productos que contienen.

Listing Product Collections

Obtén todas las colecciones de productos 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 nueva colección de productos enviando una solicitud POST al endpoint /product-collections con detalles 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 colección de productos específica, incluidos sus grupos y elementos de producto, 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 detalles de una colección de productos (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 cargándola mediante una URL prefirmada. Solicita una URL de carga al endpoint /product-collections/{id}/images y, después, 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 los productos dentro de una colección (por ejemplo, “Planes mensuales” frente a “Planes anuales”). Usa 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 colección de productos.

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 elementos de producto individuales dentro de un grupo: añade productos nuevos, actualiza elementos existentes (como el 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 de grupo: PATCH /product-collections/{id}/groups/{group_id}/items/{item_id}
• Eliminar un elemento de grupo: DELETE /product-collections/{id}/groups/{group_id}/items/{item_id}

Add Products to Group

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

Update Group Item

Actualiza un elemento de producto dentro de un grupo.

Delete Group Item

Elimina un elemento de 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 (inicial/pro/empresarial)
• Ordena estratégicamente: Coloca primero el plan más popular o recomendado, ya que aparecerá preseleccionado 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 para ofrecer flexibilidad a los clientes
• Considera el prorrateo: Elige un modo de prorrateo 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 lanzarlos

Ya puedes crear colecciones de productos y ofrecer a los clientes una experiencia unificada de selección de planes.

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 a los clientes mejorar o reducir su plan dentro de la misma colección.

Subscriptions

Gestiona planes recurrentes con prorrateo y cambios de plan.