Extensions pour les Abonnements

​

Que sont les modules complémentaires ?

​

Avantages clés

​

Création de modules complémentaires

​

Configuration des modules complémentaires

• Tarification : définissez le montant du module complémentaire (price) dans la plus petite unité monétaire. Le module complémentaire est facturé selon le cycle de l’abonnement parent
• Devise : définissez le prix de base dans n’importe quelle devise que Dodo Payments peut facturer. Le sélecteur de devise avec recherche place USD, GBP, EUR et INR en tête de liste ; les clients dont la devise ne correspond pas à votre devise de base sont facturés via Adaptive Currency
• Quantité : les clients choisissent une quantité lorsque le module complémentaire est associé à un abonnement
• Disponibilité : associez le module complémentaire aux produits d’abonnement via la liste addons de chaque produit. Le module complémentaire lui-même ne possède aucun paramètre de disponibilité
• Paramètres fiscaux : configurez le tax_category approprié

​

Premiers pas

​

Cas d’utilisation courants

• Facturation par siège : membres d’équipe supplémentaires, licences utilisateur ou utilisateurs simultanés
• Mises à niveau de fonctionnalités : fonctionnalités Premium, analyses avancées ou assistance prioritaire
• Extensions d’utilisation : stockage supplémentaire, appels API ou quotas de bande passante
• Services complémentaires : services professionnels, formations ou heures de consultation

​

Exemples d’intégration

​

Sessions de checkout avec des modules complémentaires

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
  },
});

​

Modification des plans avec des modules complémentaires

// 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=[]
)

​

Tarification dynamique

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;
}

​

Gestion via l’API

​

Bonnes pratiques

• Commencez simplement : lancez 2 à 3 modules complémentaires essentiels, puis élargissez les options en fonction des retours des clients et de l’utilisation.
• Préservez la clarté des prix : communiquez clairement le prix et la valeur des modules complémentaires afin que les clients comprennent ce qu’ils obtiennent en échange du coût supplémentaire.
• Testez rigoureusement : validez les combinaisons de modules complémentaires pour garantir l’exactitude des calculs de tarification et le bon fonctionnement des parcours de checkout.

​

Considérations de conception

• Proposition de valeur claire : chaque module complémentaire doit offrir un avantage clairement compréhensible par les clients
• Regroupement logique : regroupez les modules complémentaires associés dans votre parcours de checkout
• Quantités flexibles : permettez aux clients d’ajuster les quantités de modules complémentaires selon leurs besoins
• Tarification transparente : affichez clairement les coûts totaux tout au long du processus de checkout

​

Contenu associé