> ## 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
});
```

### 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
});
```

### Precios dinámicos

Calcula los costos totales de forma dinámica 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 con lo básico**: lanza con 2-3 complementos principales y amplía las opciones según los comentarios y el uso de los clientes.
* **Mantén claridad en los precios**: comunica claramente el precio y el valor de los complementos, para que los clientes entiendan qué obtienen por el costo adicional.
* **Prueba a fondo**: valida las combinaciones de complementos para garantizar que los cálculos de precios sigan siendo precisos y que los flujos de pago funcionen sin problemas.

### Consideraciones de diseño

* **Propuesta de valor clara**: cada complemento debe tener un beneficio evidente que los clientes puedan comprender fácilmente
* **Agrupación lógica**: agrupa complementos relacionados en tu flujo de pago
* **Cantidades flexibles**: permite que los clientes ajusten las cantidades de los complementos según lo necesiten
* **Precios transparentes**: muestra los costos totales claramente durante todo el proceso de pago

<Info>
  Los complementos son una forma potente de crear modelos de precios flexibles y escalables que crecen con tus clientes. Comienza con casos de uso sencillos y amplía según aprendas qué funciona mejor para tu negocio y tus clientes.
</Info>
