> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Complementos para Suscripciones

> Mejora tus productos de suscripción con complementos flexibles para facturación por asiento, mejoras de características y modelos de precios creativos

<Info>
  Los complementos son productos adicionales que se pueden adjuntar a tus productos de suscripción principales, lo que permite modelos de precios flexibles y experiencias de cliente mejoradas. Ya sea que necesites facturación por asiento, actualizaciones de funciones o estructuras de precios personalizadas, los complementos te brindan el poder de crear ofertas de suscripción sofisticadas.
</Info>

<CardGroup cols={2}>
  <Card title="Seat-Based Billing" icon="users" href="/developer-resources/seat-based-pricing">
    Crea complementos para asientos adicionales del equipo, licencias de usuario o mejoras de capacidad con precios por asiento.
  </Card>

  <Card title="Usage Extensions" icon="bolt" href="/features/usage-based-billing/introduction">
    Amplía los límites de uso, las llamadas de API o las asignaciones de datos con precios flexibles adicionales.
  </Card>
</CardGroup>

## ¿Qué son los complementos?

Los complementos son productos suplementarios que los clientes pueden adquirir junto con su suscripción principal. Son perfectos para:

* **Facturación por asiento**: miembros adicionales del equipo, licencias de usuario o usuarios simultáneos
* **Actualizaciones de funciones**: funciones premium, análisis avanzados o soporte prioritario
* **Extensiones de uso**: almacenamiento adicional, llamadas a la API o asignaciones de ancho de banda
* **Complementos de servicio**: servicios profesionales, capacitación o horas de consultoría

<Frame>
  <img src="https://mintcdn.com/dodopayments/ajOhO6Du1yNsg0hy/images/cookbooks/seat-based/seat-based-addons.png?fit=max&auto=format&n=ajOhO6Du1yNsg0hy&q=85&s=ea4ce0d437201c92590eea6c31a14e80" alt="Complementos adjuntos a productos de suscripción en el panel de control" style={{ maxHeight: '500px', width: 'auto' }} width="2338" height="1196" data-path="images/cookbooks/seat-based/seat-based-addons.png" />
</Frame>

## Beneficios clave

* **Modelos de precios flexibles**: ofrece planes base con complementos opcionales para crear estructuras de precios sofisticadas. Puedes atender a diversos segmentos de clientes con mejoras que crecen a medida que cambian sus necesidades.
* **Optimización de ingresos**: aumenta tu ingreso promedio por usuario (ARPU) presentando complementos relevantes. Esto permite oportunidades de venta adicional naturales a medida que los clientes añaden funciones con el tiempo.
* **Gestión simplificada**: gestiona todos los componentes de precios desde un único panel. Los complementos se incluyen automáticamente tanto en las sesiones de pago como en la gestión de suscripciones.
* **Elección del cliente**: permite que los clientes personalicen sus suscripciones seleccionando solo los complementos que necesitan, lo que mejora la satisfacción y reduce la rotación.

## Crear complementos

Los complementos se crean como productos independientes en tu panel de Dodo Payments y luego se adjuntan a tus productos de suscripción principales. Esta separación te permite:

* Reutilizar complementos en múltiples productos de suscripción
* Gestionar los precios de forma independiente
* Rastrear el rendimiento de los complementos por separado
* Actualizar complementos sin afectar las suscripciones base

<Frame>
  <img src="https://mintcdn.com/dodopayments/ajOhO6Du1yNsg0hy/images/cookbooks/seat-based/seat-based-addons-creation.png?fit=max&auto=format&n=ajOhO6Du1yNsg0hy&q=85&s=d2c17b4a9f2f9a1b19f537f0507656a4" alt="Creación de complementos en la interfaz del panel de control" style={{ maxHeight: '500px', width: 'auto' }} width="2348" height="1606" data-path="images/cookbooks/seat-based/seat-based-addons-creation.png" />
</Frame>

### Configuración del complemento

Al crear complementos, puedes configurar:

* **Precios**: establece precios únicos o recurrentes para el complemento
* **Ciclo de facturación**: debe coincidir con el ciclo de facturación de tu suscripción
* **Límites de cantidad**: establece cantidades mínimas y máximas por cliente
* **Disponibilidad**: controla qué productos de suscripción pueden usar el complemento
* **Configuración fiscal**: configura las categorías fiscales apropiadas

### Comenzar

¿Listo para implementar complementos en tu negocio de suscripción? Así es cómo empezar:

<Steps>
  <Step title="Plan Your Add-ons">
    Identifica las características, servicios o capacidades adicionales que beneficiarían a tus clientes como complementos.

    Considera:

    * ¿Qué solicitan con frecuencia los clientes?
    * ¿Qué funciones podrían monetizarse por separado?
    * ¿Qué crearía rutas de actualización naturales?
  </Step>

  <Step title="Create Your First Add-on">
    Utiliza el panel de Dodo Payments o la API para crear tu primer producto complementario.

    <Card title="Dashboard Guide" icon="box" href="/developer-resources/seat-based-pricing">
      Sigue nuestra guía paso a paso para crear complementos en el panel.
    </Card>
  </Step>

  <Step title="Attach to Subscriptions">
    Conecta tus complementos con los productos de suscripción apropiados donde deberían estar disponibles.
  </Step>

  <Step title="Test Integration">
    Crea sesiones de pago de prueba con diferentes combinaciones de complementos para asegurar que todo funcione correctamente.
  </Step>

  <Step title="Monitor Performance">
    Realiza un seguimiento de las tasas de adopción de complementos y del impacto en los ingresos para optimizar tu estrategia de precios.
  </Step>
</Steps>

## Gestión de API

Dodo Payments ofrece una API completa para gestionar complementos de forma programática:

<AccordionGroup>
  <Accordion title="Create Add-ons">
    Utiliza el endpoint `POST /addons` para crear nuevos complementos con precios personalizados, descripciones y opciones de configuración.

    <Card title="API Reference" icon="code" href="/api-reference/addons/create-addon">
      Consulta la documentación completa de la API para crear complementos.
    </Card>
  </Accordion>

  <Accordion title="Update Add-ons">
    Modifica complementos existentes usando el endpoint `PATCH /addons/{id}` para actualizar precios, descripciones o disponibilidad.

    <Card title="API Reference" icon="code" href="/api-reference/addons/update-addon">
      Aprende cómo actualizar los detalles del complemento de forma programática.
    </Card>
  </Accordion>

  <Accordion title="List and Retrieve">
    Utiliza `GET /addons` para listar todos los complementos o `GET /addons/{id}` para recuperar detalles específicos de un complemento.

    <Card title="API Reference" icon="code" href="/api-reference/addons/list-addons">
      Accede a la documentación completa de la API de listado y recuperación.
    </Card>
  </Accordion>

  <Accordion title="Image Management">
    Actualiza las imágenes de los complementos usando el endpoint `PUT /addons/{id}/images` para mejorar la presentación del producto.

    <Card title="API Reference" icon="code" href="/api-reference/addons/update-addon-images">
      Aprende a gestionar las imágenes de los complementos a través de la API.
    </Card>
  </Accordion>
</AccordionGroup>

## Casos de uso comunes

* **Facturación por asiento**: miembros adicionales del equipo, licencias de usuario o usuarios simultáneos
* **Actualizaciones de funciones**: funciones premium, análisis avanzados o soporte prioritario
* **Extensiones de uso**: almacenamiento adicional, llamadas a la API o asignaciones de ancho de banda
* **Complementos de servicio**: servicios profesionales, capacitación o horas de consultoría

## Ejemplos de integración

### Sesiones de pago con complementos

Cuando creas sesiones de pago, puedes incluir complementos con cantidades personalizadas:

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'your_subscription_id',
      quantity: 1,
      addons: [
        {
          addon_id: 'your_addon_id',
          quantity: 3 // 3 additional seats
        }
      ]
    }
  ],
  // ... other checkout options
});
```

<Tip>
  Para permitir que los clientes agreguen o eliminen complementos ellos mismos en la página de pago, establece la bandera de función [`allow_editing_addons`](/developer-resources/checkout-session#optional-fields) en `true` al crear la sesión. Por defecto, está en `false` y se aplica solo a productos de suscripción.

  ```typescript theme={null}
  const session = await client.checkoutSessions.create({
    product_cart: [{ product_id: 'your_subscription_id', quantity: 1 }],
    feature_flags: {
      allow_editing_addons: true // customers can edit add-ons at checkout
    },
  });
  ```
</Tip>

### Cambios de Plan con Complementos

Modifica suscripciones existentes para agregar, eliminar o actualizar complementos:

```typescript theme={null}
// Add add-ons to existing subscription
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [
    { addon_id: 'addon_123', quantity: 2 }
  ]
});

// Remove all existing add-ons
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [] // Empty array removes all existing add-ons
});
```

### Precio Dinámico

Calcula los costos totales dinámicamente según las selecciones de complementos:

```typescript theme={null}
function calculateTotalCost(basePrice: number, addons: AddonSelection[]) {
  const addonTotal = addons.reduce((sum, addon) => 
    sum + (addon.price * addon.quantity), 0
  );
  return basePrice + addonTotal;
}
```

## Mejores Prácticas

* **Comienza simple**: Lanza con 2-3 complementos principales y expande las opciones según los comentarios y el uso de los clientes.
* **Mantén claridad en los precios**: Comunica claramente los precios y el valor de los complementos para que los clientes entiendan lo que obtienen por el costo adicional.
* **Prueba exhaustivamente**: Valida las combinaciones de complementos para asegurar que los cálculos de precios sean precisos y los flujos de pago funcionen sin problemas.

### Consideraciones de Diseño

* **Propuesta de Valor Clara**: Cada complemento debe tener un beneficio claro que los clientes puedan entender fácilmente
* **Agrupación Lógica**: Agrupa complementos relacionados en tu flujo de pago
* **Cantidades Flexibles**: Permite a los clientes ajustar las cantidades de complementos según sea necesario
* **Precios Transparentes**: Muestra los costos totales claramente durante todo el proceso de pago

<Info>
  Los complementos son una forma poderosa de crear modelos de precios flexibles y escalables que crecen con tus clientes. Comienza con casos de uso simples y expande a medida que aprendes qué funciona mejor para tu negocio y clientes.
</Info>
