Passer au contenu principal
Les collections de produits vous permettent de regrouper des produits liés (par exemple, les plans Starter, Pro, Enterprise) sous une même bannière. Affichez toutes les options dans un seul paiement, définissez des parcours de montée/descente en gamme et donnez aux clients la possibilité de changer de plan directement depuis le Portail client.
Capture d'écran de la page de paiement de la collection de produits montrant plusieurs produits affichés

​
Points forts

  • Structure basée sur les collections : Regroupez des produits liés (plans, niveaux, options tarifaires) sous une seule collection pour une gestion organisée.
  • Une collection, plusieurs produits : Incluez plusieurs produits comme Starter, Pro, Lifetime, etc., chacun avec son propre modèle de tarification.
  • Expérience de paiement dynamique : Affichez tous les produits d’une collection dans une seule vue de paiement, permettant aux clients de choisir leur plan préféré.
  • Contrôle au niveau du marchand : Activez, désactivez et réorganisez les produits au sein de chaque collection. Le premier produit est automatiquement présélectionné au paiement.
  • Conscience du cycle de vie : Permettez aux clients de monter ou descendre en gamme entre les produits d’une même collection via le Portail client.

​
Création d’une collection de produits

Les collections de produits sont créées et gérées depuis le tableau de bord ou via l’API. Chaque collection agit comme un conteneur pour des produits associés.
1

Create the collection

Définissez la collection avec un nom et une description facultative. Téléversez une image pour représenter visuellement la collection lors du paiement.
Capture d'écran du formulaire de création de la collection de produits dans le tableau de bord montrant les champs pour le nom, la description et le téléversement d'images
Champs de la collection :
  • Nom (obligatoire) : Nom affiché de la collection (par ex., « Plans SaaS », « Niveaux de licence »)
  • Description (facultative) : Brève explication affichée lors du paiement
  • Image (facultative) : Identification visuelle de la collection
2

Add products to the collection

Ajoutez des produits existants à votre collection. Les produits peuvent être organisés en groupes pour une meilleure structuration.
Capture d'écran de la page des produits de la collection de produits montrant une liste de produits et la possibilité de les ajouter à la collection
Organisation des produits :
  • Groupes : Organisez éventuellement les produits en groupes nommés (par ex., « Plans mensuels », « Plans annuels »)
  • Produits non groupés : Les produits sans groupe apparaissent au niveau de la collection
  • Ordre : Glissez-déposez pour définir l’ordre d’affichage
Chaque produit ne peut appartenir qu’à une seule collection. Si un produit appartient déjà à une autre collection, vous devrez d’abord le retirer.
3

Configure ordering and visibility

Contrôlez l’ordre d’affichage et la visibilité des produits au sein de la collection.Options de configuration :
  • Statut du produit : Activez ou désactivez individuellement les produits dans la collection
  • Ordre d’affichage : Glissez-déposez pour définir la séquence d’apparition des produits lors du paiement
Le premier produit de la collection est automatiquement présélectionné par défaut lors du paiement. Réorganisez les produits pour changer celui qui est sélectionné par défaut.

​
Paiement par collection

Les collections permettent une expérience de paiement unifiée où les clients peuvent voir et sélectionner tous les produits disponibles en un seul endroit.

​
Types de paiement

TypeDescriptionCas d’usage
Paiement par collectionAffiche tous les produits actifs d’une collectionSélection de plan d’abonnement, tarification par niveau
Paiement d’un seul produitAffiche uniquement un produit spécifiqueAchat direct, liens promotionnels

​
Expérience de paiement par collection

Lorsque vous utilisez un paiement par collection :
  1. Tous les produits actifs affichés : Les clients voient chaque produit activé dans la collection
  2. Premier produit présélectionné : Le premier produit dans l’ordre de la collection est automatiquement sélectionné
  3. Détails des produits affichés : Chaque produit affiche son nom, sa description et sa tarification
  4. Sélection unique : Le client sélectionne un produit à acheter
  5. Flux standard poursuivi : Après la sélection, le paiement continue avec la tarification et les paramètres de facturation du produit choisi
Capture d'écran de la page de paiement de la collection de produits montrant plusieurs produits affichés
Le paiement par collection est idéal pour les entreprises d’abonnement qui souhaitent que les clients comparent les plans côte à côte avant d’acheter.

​
Intégration API

Créez une session de paiement pour une collection : 
const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

// Redirect customer to the checkout
window.location.href = session.checkout_url;
Lorsque vous utilisez product_collection_id, les codes de réduction ne peuvent pas être appliqués lors de la création de la session. Les clients peuvent toujours saisir des codes de réduction pendant le paiement si cette option est activée.

​
Intégration au portail client

Les clients peuvent monter ou descendre en gamme entre les produits d’une même collection directement depuis le Portail client.
Vous avez déjà des produits d’abonnement ? Ajoutez-les simplement à une collection de produits pour activer les parcours de montée/descente en gamme dans le Portail client. Pas besoin de recréer vos produits.

​
Actions de gestion des plans

ActionDescriptionContrôle du marchand
Afficher le plan actuelAffiche le nom du produit en cours, son prix et sa date de renouvellementToujours disponible
Upgrade de planPassez à un produit de niveau supérieur dans la même collectionConfigurable (par défaut : autorisé)
Downgrade de planPassez à un produit de niveau inférieur dans la même collectionConfigurable (par défaut : autorisé)
AnnulerAnnule l’abonnement entièrementToujours disponible
Capture d'écran de l'interface de changement de plan du portail client de la collection de produits montrant les actions de gestion de plan

​
Règles de montée/descente en gamme

  • Les montées et descentes en gamme ne sont disponibles qu’entre les produits au sein de la même collection
  • La proratisation est appliquée en fonction de vos paramètres d’abonnement
  • Des notifications par e-mail sont envoyées à l’entreprise à chaque montée, descente ou annulation
Capture d'écran de l'interface de changement de plan du portail client de la collection de produits montrant les actions de gestion de plan
Les clients ne peuvent pas passer à des produits situés en dehors de leur collection actuelle. Créez des collections distinctes pour des gammes de produits différentes.

​
Paramètres d’abonnement

Configurez le fonctionnement des abonnements et des changements de plan dans votre entreprise depuis Paramètres → Abonnements dans votre tableau de bord.
Capture d'écran de la page des paramètres d'abonnement montrant les bascules Autoriser plusieurs abonnements et Autoriser les mises à jour d'abonnement

​
Paramètres disponibles

ParamètreDescriptionValeur par défaut
Autoriser plusieurs abonnementsLes clients peuvent avoir plus d’un abonnement actif simultanémentActivé
Autoriser les mises à jour d’abonnementLes clients peuvent monter ou descendre en gamme de leurs abonnements existants à tout moment via le Portail clientDésactivé
Les changements de plan via le portail client sont désactivés par défaut. Activez “Autoriser les mises à jour d’abonnement” dans Paramètres → Abonnements pour permettre aux clients de monter ou descendre en gamme entre les produits d’une même collection.

Subscription Plan Changes

En savoir plus sur les modes de proratisation et le comportement des changements de plan.

​
Gestion des collections

Les collections de produits peuvent être gérées soit via le tableau de bord Dodo Payments, soit de manière programmatique via l’API. L’API offre un contrôle total sur la création des collections, les mises à jour, le téléchargement d’images, l’archivage et la gestion des groupes et produits imbriqués.

​
Opérations du tableau de bord

  • Créer : Configurer de nouvelles collections avec des produits et des groupes
  • Mettre à jour : Modifier le nom, la description, l’image et l’organisation des produits
  • Réorganiser : Glisser-déposer pour changer l’ordre d’affichage des produits
  • Activer/Désactiver les produits : Contrôler quels produits apparaissent lors du paiement
  • Archiver : Cacher une collection sans la supprimer définitivement (peut être désarchivée plus tard)
Capture d'écran du tableau de bord des collections de produits montrant les opérations de gestion des collections

​
Gestion de l’API

Les points de terminaison suivants vous permettent de créer, mettre à jour, récupérer, archiver et organiser des collections de produits de manière programmatique — y compris la gestion des groupes imbriqués et des produits qu’ils contiennent.
Récupérez toutes les collections de produits associées à votre compte en utilisant une demande GET au point de terminaison /product-collections. Prend en charge la pagination, le filtrage par marque et l’inclusion de collections archivées.

List Product Collections API

Consulter la structure détaillée des demandes et des réponses dans la documentation de l’API List Product Collections.
Créez une nouvelle collection de produits en envoyant une demande POST au point de terminaison /product-collections avec des détails tels que le nom, la description et la marque.

Create Product Collection API

Consulter la structure détaillée des demandes et des réponses dans la documentation de l’API Create Product Collection.
Obtenez des informations détaillées sur une collection de produits spécifique — y compris ses groupes et ses articles de produits — en utilisant une demande GET au point de terminaison /product-collections/{id}.

Get Product Collection API

Consulter la structure détaillée des demandes et des réponses dans la documentation de l’API Get Product Collection.
Modifiez les détails d’une collection de produits (nom, description, marque, etc.) en envoyant une demande PATCH au point de terminaison /product-collections/{id}.

Update Product Collection API

Consulter la structure détaillée des demandes et des réponses dans la documentation de l’API Update Product Collection.
Associez une image à une collection en la téléchargeant via une URL pré-signée. Demandez une URL de téléchargement au point de terminaison /product-collections/{id}/images, puis PUT l’image à l’URL retournée dans les 60 secondes.
L’URL pré-signée expire après 60 secondes, donc l’image doit être téléchargée dans ce délai.

Update Collection Images API

Consulter la structure détaillée des demandes et des réponses dans la documentation de l’API Update Collection Images.
Archivez une collection en envoyant une demande DELETE au point de terminaison /product-collections/{id}. Cela cache la collection de nouveaux usages mais ne la supprime pas définitivement.

Archive Product Collection API

Consulter la structure détaillée des demandes et des réponses dans la documentation de l’API Archive Product Collection.
Restaurez une collection archivée en envoyant une demande POST au point de terminaison /product-collections/{id}/unarchive.

Unarchive Product Collection API

Consulter la structure détaillée des demandes et des réponses dans la documentation de l’API Unarchive Product Collection.
Les groupes vous permettent d’organiser les produits à l’intérieur d’une collection (par exemple, “Plans mensuels” vs. “Plans annuels”). Utilisez les points de terminaison des groupes pour ajouter, mettre à jour ou supprimer des groupes au sein d’une collection.
  • Créer un groupe : POST /product-collections/{id}/groups
  • Mettre à jour un groupe : PATCH /product-collections/{id}/groups/{group_id}
  • Supprimer un groupe : DELETE /product-collections/{id}/groups/{group_id}

Create Group

Ajouter un nouveau groupe à une collection de produits.

Update Group

Modifier le nom ou les attributs d’un groupe.

Delete Group

Supprimer un groupe d’une collection.
Gérez les articles de produits individuels à l’intérieur d’un groupe — ajoutez de nouveaux produits, mettez à jour les éléments existants (comme l’ordre d’affichage), ou supprimez-les entièrement.
  • Ajouter des produits à un groupe : POST /product-collections/{id}/groups/{group_id}/items
  • Mettre à jour un élément de groupe : PATCH /product-collections/{id}/groups/{group_id}/items/{item_id}
  • Supprimer un élément de groupe : DELETE /product-collections/{id}/groups/{group_id}/items/{item_id}

Add Products to Group

Ajouter un ou plusieurs produits à un groupe au sein d’une collection.

Update Group Item

Mettre à jour un élément de produit dans un groupe.

Delete Group Item

Supprimer un élément de produit d’un groupe.

​
Meilleures pratiques

  • Regrouper logiquement : Organiser les produits par intervalle de facturation (mensuel/annuel) ou niveau de fonctionnalité (starter/pro/entreprise)
  • Commander stratégiquement : Placez votre plan le plus populaire ou recommandé en premier, car il sera pré-sélectionné lors du paiement
  • Utiliser des noms clairs : Les noms de produits doivent communiquer clairement les différences de valeur
  • Permettre les deux directions : Autorisez à la fois les mises à niveau et les rétrogradations pour offrir une flexibilité aux clients
  • Considérer la proratisation : Choisissez un mode de proratisation qui correspond à votre modèle commercial
  • Tester soigneusement : Vérifiez les flux de paiement et de changement de plan en mode test avant de passer en direct
Vous êtes prêt à créer des collections de produits et à offrir aux clients une expérience de sélection de plan unifiée.

Products

Créez des produits ponctuels, par abonnement ou basés sur l’utilisation à ajouter aux collections.

Checkout

Afficher les produits de la collection dans une expérience de paiement unifiée.

Customer Portal

Permettre aux clients de mettre à niveau ou de rétrograder au sein de la même collection.

Subscriptions

Gérez les plans récurrents avec proratisation et changements de plan.
Last modified on May 28, 2026