Saltar al contenido principal
Las Colecciones de Productos te permiten agrupar productos relacionados (por ejemplo, planes Starter, Pro, Enterprise) bajo un mismo paraguas. Muestra todas las opciones en un solo pago, define rutas de actualización/diminuación y brinda a los clientes la flexibilidad de cambiar de planes directamente desde el Portal del Cliente.
Captura de pantalla de la página de pago de la Colección de Productos mostrando múltiples 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

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

Crea la colección

Define la colección con un nombre y una descripción opcional. Sube una imagen para representar visualmente la colección en el pago.
Captura de pantalla del formulario de creación de la Colección de Productos en el panel de control mostrando campos para nombre, descripción y carga de imagen
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

Agregar productos a la colección

Agrega productos existentes a tu colección. Los productos pueden organizarse en grupos para una mejor estructura.
Captura de pantalla de la página de productos de la Colección de Productos mostrando una lista de productos y la capacidad de añadirlos a la colección
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, primero debes eliminarlo.
3

Configurar el orden y visibilidad

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 en la colección se selecciona automáticamente como el predeterminado en el pago. 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

TipoDescripciónCaso de Uso
Pago de ColecciónMuestra todos los productos activos dentro de una colecciónSelección de plan de suscripción, precios en capas
Pago de Producto ÚnicoMuestra solo un producto específicoCompra 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
Captura de pantalla de la página de pago de la Colección de Productos mostrando múltiples productos
El pago de colección es ideal para negocios de suscripción donde deseas 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.url;
Cuando uses product_collection_id, no se pueden aplicar códigos de descuento en la creación de la sesión. Los clientes aún pueden ingresar códigos de descuento durante el pago 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.

Acciones de Gestión de Planes

AcciónDescripciónControl del Comerciante
Ver Plan ActualMuestra el nombre, precio y fecha de renovación del producto actualSiempre disponible
Actualizar PlanMueve a un producto de mayor nivel en la misma colecciónConfigurable (predeterminado: permitido)
Disminuir PlanMueve a un producto de menor nivel en la misma colecciónConfigurable (predeterminado: permitido)
CancelarCancela la suscripción por completoSiempre disponible
Captura de pantalla de la interfaz de cambio de plan del portal del cliente de la Colección de Productos mostrando las acciones de gestión de planes

Reglas de Actualización/Diminución

  • Las actualizaciones y disminuciones solo están disponibles entre productos dentro de la misma colección
  • Se aplica prorrateo según la configuración de tu suscripción
  • Se envían notificaciones por correo electrónico al negocio en cada actualización, disminución o cancelación
Captura de pantalla de la interfaz de cambio de plan del portal del cliente de la Colección de Productos mostrando las acciones de gestión de planes
Los clientes no pueden cambiar a productos fuera de su colección actual. Crea colecciones separadas para líneas de productos distintas.

Configuración de Suscripciones

Configura cómo funcionan las suscripciones y los cambios de planes en tu negocio desde la sección de Configuración de Suscripciones en tu panel de control.
Captura de pantalla de la página de configuración de suscripciones mostrando los interruptores de Permitir Múltiples Suscripciones y Permitir Actualizaciones de Suscripción

Configuraciones Disponibles

ConfiguraciónDescripciónPredeterminado
Permitir Múltiples SuscripcionesLos clientes pueden tener más de una suscripción activa al mismo tiempoHabilitado
Permitir Actualizaciones de SuscripciónLos clientes pueden actualizar o disminuir sus suscripciones existentes en cualquier momento a través del Portal del ClienteDeshabilitado
Los cambios de plan a través del Portal del Cliente están deshabilitados de manera predeterminada. Habilita “Permitir Actualizaciones de Suscripción” en tu Configuración de Suscripciones para permitir que los clientes actualicen o disminuyan entre productos en la misma colección.

Cambios en el Plan de Suscripción

Aprende más sobre los modos de prorrateo y el comportamiento de cambio de plan.

Gestión de Colecciones

Las Colecciones de Productos se crean y gestionan exclusivamente a través del panel de control de Dodo Payments.
Crear, actualizar y eliminar colecciones solo está disponible a través del panel de control. La API proporciona acceso de solo lectura para recuperar datos de colecciones con fines de integración.

Operaciones en el Panel de Control

  • Crear: Configura nuevas colecciones con productos y grupos
  • Actualizar: Modifica nombre, descripción, imagen y organización de productos
  • Reordenar: Arrastra y suelta para cambiar el orden de visualización de productos
  • Habilitar/Deshabilitar productos: Controla qué productos aparecen en el pago
  • Eliminar: Elimina una colección (los productos permanecen pero están desvinculados)
Captura de pantalla del panel de control de la Colección de Productos mostrando las operaciones de gestión de colecciones

Mejores Prácticas

  • Agrupa lógicamente: Organiza productos por intervalo de facturación (mensual/anual) o nivel de características (starter/pro/enterprise)
  • Ordena estratégicamente: Coloca tu plan más popular o recomendado primero, ya que será preseleccionado en el pago
  • Usa nombres claros: Los nombres de los productos deben comunicar claramente las diferencias de valor
  • Permite ambas direcciones: Permite tanto actualizaciones como disminuciones para ofrecer flexibilidad a los clientes
  • Considera el prorrateo: Elige un modo de prorrateo que se alinee con tu modelo de negocio
  • Prueba a fondo: Verifica los flujos de pago y cambio de plan en modo de prueba antes de lanzarlo
Estás listo para crear colecciones de productos y ofrecer a los clientes una experiencia de selección de planes unificada.