> ## 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.

# Extensions pour les Abonnements

> Améliorez vos produits d'abonnement avec des extensions flexibles pour la facturation par siège, les mises à niveau de fonctionnalités et des modèles de tarification créatifs

<Info>
  Les add-ons sont des produits supplémentaires qui peuvent être attachés à vos produits d'abonnement principaux, permettant des modèles de tarification flexibles et des expériences client améliorées. Que vous ayez besoin de facturation par siège, de mises à niveau de fonctionnalités ou de structures de tarification personnalisées, les add-ons vous donnent le pouvoir de créer des offres d'abonnement sophistiquées.
</Info>

<CardGroup cols={2}>
  <Card title="Seat-Based Billing" icon="users" href="/developer-resources/seat-based-pricing">
    Créez des add-ons pour des sièges d'équipe supplémentaires, des licences utilisateur ou des mises à niveau de capacité avec une tarification par siège.
  </Card>

  <Card title="Usage Extensions" icon="bolt" href="/features/usage-based-billing/introduction">
    Étendre les limites d'utilisation, les appels d'API ou les allocations de données avec une tarification flexible des modules complémentaires.
  </Card>
</CardGroup>

## Quels sont les add-ons ?

Les add-ons sont des produits complémentaires que les clients peuvent acheter en plus de leur abonnement principal. Ils sont parfaits pour :

* **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 support prioritaire
* **Extensions d'utilisation** : Stockage supplémentaire, appels API ou allocations de bande passante
* **Add-ons de services** : Services professionnels, formations ou heures de conseil

<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="Modules complémentaires attachés aux produits d'abonnement dans le tableau de bord" style={{ maxHeight: '500px', width: 'auto' }} width="2338" height="1196" data-path="images/cookbooks/seat-based/seat-based-addons.png" />
</Frame>

## Avantages clés

* **Modèles de tarification flexibles** : Proposez des formules de base avec des add-ons facultatifs pour créer des structures de tarification sophistiquées. Vous pouvez répondre à des segments de clientèle divers avec des mises à niveau qui évoluent en fonction des besoins de vos clients.
* **Optimisation des revenus** : Augmentez votre revenu moyen par utilisateur (ARPU) en présentant des add-ons pertinents. Cela permet de créer des opportunités d'upsell naturelles au fur et à mesure que les clients ajoutent des fonctionnalités.
* **Gestion simplifiée** : Gérez tous les éléments de tarification depuis un seul tableau de bord. Les add-ons sont automatiquement inclus dans les sessions de paiement et la gestion des abonnements.
* **Choix du client** : Permettez aux clients de personnaliser leurs abonnements en sélectionnant uniquement les add-ons dont ils ont besoin, ce qui augmente la satisfaction et réduit le churn.

## Création d'add-ons

Les add-ons sont créés comme des produits distincts dans votre tableau de bord Dodo Payments, puis rattachés à vos principaux produits d'abonnement. Cette séparation vous permet de :

* Réutiliser les add-ons sur plusieurs produits d'abonnement
* Gérer les tarifs indépendamment
* Suivre les performances des add-ons séparément
* Mettre à jour les add-ons sans affecter les abonnements de 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="Création de modules complémentaires dans l'interface du tableau de bord" style={{ maxHeight: '500px', width: 'auto' }} width="2348" height="1606" data-path="images/cookbooks/seat-based/seat-based-addons-creation.png" />
</Frame>

### Configuration des add-ons

Lors de la création d'add-ons, vous pouvez configurer :

* **Tarification** : Définissez un tarif unique ou récurrent pour l'add-on
* **Cycle de facturation** : Doit correspondre au cycle de facturation de votre abonnement
* **Limites de quantité** : Définissez des quantités minimales et maximales par client
* **Disponibilité** : Contrôlez les produits d'abonnement pouvant utiliser l'add-on
* **Paramètres fiscaux** : Configurez les catégories fiscales appropriées

### Premiers pas

Prêt à implémenter des add-ons dans votre activité d'abonnement ? Voici comment commencer :

<Steps>
  <Step title="Plan Your Add-ons">
    Identifiez les fonctionnalités, services ou capacités supplémentaires qui bénéficieraient à vos clients en tant qu'add-ons.

    Considérez :

    * Que demandent fréquemment les clients ?
    * Quelles fonctionnalités pourraient être monétisées séparément ?
    * Qu'est-ce qui créerait des parcours de montée en gamme naturels ?
  </Step>

  <Step title="Create Your First Add-on">
    Utilisez le tableau de bord ou l'API de Dodo Payments pour créer votre premier produit add-on.

    <Card title="Dashboard Guide" icon="box" href="/developer-resources/seat-based-pricing">
      Suivez notre guide pas à pas pour créer des add-ons dans le tableau de bord.
    </Card>
  </Step>

  <Step title="Attach to Subscriptions">
    Connectez vos add-ons aux produits d'abonnement appropriés où ils doivent être disponibles.
  </Step>

  <Step title="Test Integration">
    Créez des sessions de paiement de test avec différentes combinaisons d'add-ons pour vous assurer que tout fonctionne correctement.
  </Step>

  <Step title="Monitor Performance">
    Suivez les taux d'adoption des add-ons et l'impact sur les revenus pour optimiser votre stratégie tarifaire.
  </Step>
</Steps>

## Gestion de l'API

Dodo Payments propose une API complète pour gérer les add-ons de manière programmatique :

<AccordionGroup>
  <Accordion title="Create Add-ons">
    Utilisez le `POST /addons` pour créer de nouveaux add-ons avec des tarifs, des descriptions et des options de configuration personnalisés.

    <Card title="API Reference" icon="code" href="/api-reference/addons/create-addon">
      Consultez la documentation API complète pour la création d'add-ons.
    </Card>
  </Accordion>

  <Accordion title="Update Add-ons">
    Modifiez les add-ons existants en utilisant le `PATCH /addons/{id}` pour mettre à jour les tarifs, les descriptions ou la disponibilité.

    <Card title="API Reference" icon="code" href="/api-reference/addons/update-addon">
      Apprenez à mettre à jour les détails des add-ons de manière programmatique.
    </Card>
  </Accordion>

  <Accordion title="List and Retrieve">
    Utilisez `GET /addons` pour lister tous les add-ons ou `GET /addons/{id}` pour récupérer les détails d'un add-on spécifique.

    <Card title="API Reference" icon="code" href="/api-reference/addons/list-addons">
      Accédez à la documentation API complète pour le listing et la récupération.
    </Card>
  </Accordion>

  <Accordion title="Image Management">
    Mettez à jour les images des add-ons en utilisant le `PUT /addons/{id}/images` pour une meilleure présentation des produits.

    <Card title="API Reference" icon="code" href="/api-reference/addons/update-addon-images">
      Découvrez comment gérer les images des add-ons via l'API.
    </Card>
  </Accordion>
</AccordionGroup>

## 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 support prioritaire
* **Extensions d'utilisation** : Stockage supplémentaire, appels API ou allocations de bande passante
* **Add-ons de services** : Services professionnels, formations ou heures de conseil

## Exemples d'intégration

### Sessions de paiement avec add-ons

Lors de la création de sessions de paiement, vous pouvez inclure des add-ons avec des quantités personnalisées :

```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>
  Pour permettre aux clients d'ajouter ou de retirer eux-mêmes des compléments sur la page de paiement, définissez le drapeau de fonctionnalité [`allow_editing_addons`](/developer-resources/checkout-session#optional-fields) sur `true` lors de la création de la session. Par défaut, il est sur `false` et ne s'applique qu'aux produits par abonnement.

  ```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>

### Modifications de plan avec compléments

Modifiez les abonnements existants pour ajouter, retirer ou mettre à jour des compléments :

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

### Tarification dynamique

Calculez les coûts totaux dynamiquement en fonction des sélections de compléments :

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

## Meilleures pratiques

* **Commencez simplement** : Lancez avec 2-3 compléments principaux et élargissez les options en fonction des retours clients et de l'utilisation.
* **Conservez la clarté des prix** : Communiquez clairement le prix et la valeur des compléments, afin que les clients comprennent ce qu'ils obtiennent pour le coût supplémentaire.
* **Testez minutieusement** : Validez les combinaisons de compléments pour garantir que les calculs de prix restent précis et que les flux de paiement fonctionnent sans accroc.

### Considérations de design

* **Proposition de valeur claire** : Chaque complément doit avoir un avantage clair que les clients peuvent facilement comprendre
* **Regroupement logique** : Regroupez les compléments liés ensemble dans votre flux de paiement
* **Quantités flexibles** : Permettez aux clients d'ajuster les quantités de compléments selon leurs besoins
* **Transparence des prix** : Affichez clairement les coûts totaux tout au long du processus de paiement

<Info>
  Les compléments sont un moyen puissant de créer des modèles de tarification flexibles et évolutifs qui évoluent avec vos clients. Commencez avec des cas d'utilisation simples et développez-vous au fur et à mesure que vous apprenez ce qui fonctionne le mieux pour votre entreprise et vos clients.
</Info>
