Collections de produits

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.

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

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.

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

Type	Description	Cas d’usage
Paiement par collection	Affiche tous les produits actifs d’une collection	Sélection de plan d’abonnement, tarification par niveau
Paiement d’un seul produit	Affiche uniquement un produit spécifique	Achat direct, liens promotionnels

Expérience de paiement par collection

Lorsque vous utilisez un paiement par collection :

Tous les produits actifs affichés : Les clients voient chaque produit activé dans la collection
Premier produit présélectionné : Le premier produit dans l’ordre de la collection est automatiquement sélectionné
Détails des produits affichés : Chaque produit affiche son nom, sa description et sa tarification
Sélection unique : Le client sélectionne un produit à acheter
Flux standard poursuivi : Après la sélection, le paiement continue avec la tarification et les paramètres de facturation du produit choisi

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

Action	Description	Contrôle du marchand
Afficher le plan actuel	Affiche le nom du produit en cours, son prix et sa date de renouvellement	Toujours disponible
Upgrade de plan	Passez à un produit de niveau supérieur dans la même collection	Configurable (par défaut : autorisé)
Downgrade de plan	Passez à un produit de niveau inférieur dans la même collection	Configurable (par défaut : autorisé)
Annuler	Annule l’abonnement entièrement	Toujours 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

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.

Paramètres disponibles

Setting	Description	Default
Autoriser plusieurs abonnements	Les clients peuvent détenir plusieurs abonnements actifs simultanément	Activé
Autoriser les mises à jour d’abonnement	Les clients peuvent mettre à niveau ou rétrograder leurs abonnements existants à tout moment via le Customer Portal	Désactivé
Autoriser l’annulation d’abonnement	Les clients peuvent annuler eux-mêmes leurs abonnements depuis le Customer Portal	Activé
Empêcher l’utilisation abusive des essais	Les clients ayant déjà utilisé un essai passent à un achat payant sans essai au lieu de bénéficier d’un nouvel essai	Dé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.

La désactivation de l’option « Autoriser l’annulation d’abonnement » masque l’annulation en libre-service pour les clients et rejette les demandes d’annulation effectuées via l’API Customer Portal. Les annulations effectuées de votre côté marchand ne sont pas concernées. Consultez Annuler un abonnement.

Pour plus d’informations sur la manière dont les utilisations d’essai sont associées et enregistrées, consultez Empêcher l’utilisation abusive des essais.

Subscription Plan Changes

En savoir plus sur les modes de proratisation et le comportement lors d’un changement de plan.

Gérer les collections

Les collections de produits peuvent être gérées depuis le tableau de bord Dodo Payments ou par programmation via l’API. L’API offre un contrôle complet sur la création, la mise à jour, l’importation d’images et l’archivage des collections, ainsi que sur la gestion des groupes imbriqués et des produits.

Opérations dans le tableau de bord

Créer : Configurez de nouvelles collections avec des produits et des groupes
Mettre à jour : Modifiez le nom, la description, l’image et l’organisation des produits
Réorganiser : Faites glisser-déposer les éléments pour modifier l’ordre d’affichage des produits
Activer/Désactiver des produits : Contrôlez les produits qui apparaissent lors du checkout
Archiver : Masquez une collection sans la supprimer définitivement (elle pourra être désarchivée ultérieurement)

Capture d’écran du tableau de bord des collections de produits présentant les opérations de gestion des collections

Gestion via l’API

Les endpoints suivants vous permettent de créer, mettre à jour, récupérer, archiver et organiser des collections de produits par programmation, notamment de gérer les groupes imbriqués et les produits qu’ils contiennent.

Listing Product Collections

Récupérez toutes les collections de produits associées à votre compte à l’aide d’une requête GET vers l’endpoint /product-collections. La pagination est prise en charge, ainsi que le filtrage par marque et l’inclusion des collections archivées.

List Product Collections API

Consultez la structure détaillée des requêtes et des réponses dans la documentation de l’API List Product Collections.

Creating a Product Collection

Créez une nouvelle collection de produits en envoyant une requête POST vers l’endpoint /product-collections, avec des informations telles que le nom, la description et la marque.

Create Product Collection API

Consultez la structure détaillée des requêtes et des réponses dans la documentation de l’API Create Product Collection.

Retrieving a Product Collection

Obtenez des informations détaillées sur une collection de produits spécifique, notamment ses groupes et ses produits, à l’aide d’une requête GET vers l’endpoint /product-collections/{id}.

Get Product Collection API

Consultez la structure détaillée des requêtes et des réponses dans la documentation de l’API Get Product Collection.

Updating a Product Collection

Modifiez les détails d’une collection de produits (nom, description, marque, etc.) en envoyant une requête PATCH vers l’endpoint /product-collections/{id}.

Update Product Collection API

Consultez la structure détaillée des requêtes et des réponses dans la documentation de l’API Update Product Collection.

Uploading Collection Images

Associez une image à une collection en la téléversant via une URL pré-signée. Demandez une URL de téléversement à l’endpoint /product-collections/{id}/images, puis PUT l’image vers l’URL retournée dans un délai de 60 secondes.

L’URL pré-signée expire au bout de 60 secondes : l’image doit donc être téléversée dans ce délai.

Update Collection Images API

Consultez la structure détaillée des requêtes et des réponses dans la documentation de l’API Update Collection Images.

Archiving a Product Collection

Archivez une collection en envoyant une requête DELETE vers l’endpoint /product-collections/{id}. La collection n’est alors plus disponible pour une nouvelle utilisation, mais n’est pas supprimée définitivement.

Archive Product Collection API

Consultez la structure détaillée des requêtes et des réponses dans la documentation de l’API Archive Product Collection.

Unarchiving a Product Collection

Restaurez une collection archivée en envoyant une requête POST vers l’endpoint /product-collections/{id}/unarchive.

Unarchive Product Collection API

Consultez la structure détaillée des requêtes et des réponses dans la documentation de l’API Unarchive Product Collection.

Managing Groups within a Collection

Les groupes vous permettent d’organiser les produits au sein d’une collection (par exemple, « Formules mensuelles » et « Formules annuelles »). Utilisez les endpoints 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

Ajoutez un nouveau groupe à une collection de produits.

Update Group

Modifiez le nom ou les attributs d’un groupe.

Delete Group

Supprimez un groupe d’une collection.

Managing Products within a Group

Gérez les produits individuels au sein d’un groupe : ajoutez de nouveaux produits, mettez à jour les éléments existants (par exemple, leur 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

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

Update Group Item

Mettez à jour un produit au sein d’un groupe.

Delete Group Item

Supprimez un produit d’un groupe.

Bonnes pratiques

Regrouper logiquement : Organisez les produits par intervalle de facturation (mensuel/annuel) ou par niveau de fonctionnalités (débutant/professionnel/entreprise)
Définir un ordre stratégique : Placez votre plan le plus populaire ou recommandé en premier, car il sera présélectionné lors du checkout
Utiliser des noms clairs : Les noms des produits doivent communiquer clairement les différences de valeur
Autoriser les deux directions : Permettez à la fois les mises à niveau et les rétrogradations afin d’offrir plus de flexibilité aux clients
Tenir compte de la proratisation : Choisissez un mode de proratisation adapté à votre modèle économique
Tester minutieusement : Vérifiez les parcours de checkout et de changement de plan en mode test avant la mise en production

Vous êtes maintenant prêt à créer des collections de produits et à offrir à vos clients une expérience unifiée de sélection de plans.

Products

Créez des produits ponctuels, par abonnement ou facturés à l’usage à ajouter aux collections.

Checkout

Affichez les produits d’une collection dans une expérience de checkout unifiée.

Customer Portal

Permettez aux clients de mettre à niveau ou de rétrograder leur plan au sein d’une même collection.

Subscriptions

Gérez les plans récurrents avec la proratisation et les changements de plan.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Points forts

Création d’une collection de produits