Complementos para Suscripciones

​

¿Qué son los complementos?

​

Ventajas principales

​

Creación de complementos

​

Configuración de complementos

• Precio: Establece el importe del complemento (price) en la unidad monetaria más pequeña. El complemento se factura según el ciclo de la suscripción principal
• Moneda: Establece el precio base en cualquier moneda que Dodo Payments pueda cobrar. El selector de monedas con búsqueda fija USD, GBP, EUR y INR en la parte superior; a los clientes que estén fuera de tu moneda base se les factura mediante Adaptive Currency
• Cantidad: Los clientes eligen una cantidad cuando el complemento se adjunta a una suscripción
• Disponibilidad: Adjunta el complemento a productos de suscripción mediante la lista addons de cada producto. El complemento no tiene su propia configuración de disponibilidad
• Configuración de impuestos: Configura el tax_category correspondiente

​

Primeros pasos

​

Casos de uso frecuentes

• Facturación basada en plazas: Miembros adicionales del equipo, licencias de usuario o usuarios simultáneos
• Actualizaciones de funcionalidades: Funcionalidades premium, análisis avanzados o soporte prioritario
• Ampliaciones de uso: Almacenamiento adicional, llamadas a la API o cuotas de ancho de banda
• Servicios adicionales: Servicios profesionales, formación u horas de consultoría

​

Ejemplos de integración

​

Sesiones de checkout con complementos

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1,
      addons: [
        {
          addon_id: 'addon_456',
          quantity: 3 // 3 additional seats
        }
      ]
    }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

session = client.checkout_sessions.create(
    product_cart=[
        {
            "product_id": "pdt_123",
            "quantity": 1,
            "addons": [
                {
                    "addon_id": "addon_456",
                    "quantity": 3  # 3 additional seats
                }
            ]
        }
    ],
    customer={"email": "customer@example.com"},
    return_url="https://yourapp.com/success"
)

curl -X POST https://test.dodopayments.com/checkouts \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      {
        "product_id": "pdt_123",
        "quantity": 1,
        "addons": [
          {
            "addon_id": "addon_456",
            "quantity": 3
          }
        ]
      }
    ],
    "customer": {"email": "customer@example.com"},
    "return_url": "https://yourapp.com/success"
  }'

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  feature_flags: {
    allow_editing_addons: true // customers can edit add-ons at checkout
  },
});

​

Cambios de plan con complementos

// Add add-ons to existing subscription
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_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: 'pdt_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [] // Empty array removes all existing add-ons
});

# Add add-ons to existing subscription
client.subscriptions.change_plan(
    'sub_123',
    product_id='pdt_new',
    quantity=1,
    proration_billing_mode='difference_immediately',
    addons=[
        {'addon_id': 'addon_123', 'quantity': 2}
    ]
)

# Remove all existing add-ons
client.subscriptions.change_plan(
    'sub_123',
    product_id='pdt_new',
    quantity=1,
    proration_billing_mode='difference_immediately',
    addons=[]
)

​

Precios dinámicos

interface AddonSelection {
  price: number;
  quantity: number;
}

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

​

Gestión mediante la API

​

Prácticas recomendadas

• Empieza de forma sencilla: Lanza entre 2 y 3 complementos principales y amplía las opciones según los comentarios y el uso de los clientes.
• Mantén la claridad de los precios: Comunica claramente el precio y el valor de los complementos para que los clientes entiendan qué obtienen por el coste adicional.
• Prueba exhaustivamente: Valida las combinaciones de complementos para asegurarte de que los cálculos de precios sigan siendo precisos y los flujos de checkout funcionen correctamente.

​

Consideraciones de diseño

• Propuesta de valor clara: Cada complemento debe ofrecer un beneficio claro que los clientes puedan entender
• Agrupación lógica: Agrupa los complementos relacionados en el flujo de checkout
• Cantidades flexibles: Permite que los clientes ajusten las cantidades de los complementos según sea necesario
• Precios transparentes: Muestra claramente los costes totales durante todo el proceso de checkout

​

Relacionado