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
Voir le plan actuel	Afficher le nom du produit actuel, son prix et sa date de renouvellement	Toujours disponible
Mettre à niveau le plan	Passer à un produit de niveau supérieur dans la même collection	Configurable (désactivé par défaut)
Rétrograder le plan	Passer à un produit de niveau inférieur dans la même collection	Configurable (désactivé par défaut)
Annuler	Annuler entièrement l’abonnement	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

Paramètre	Description	Valeur par défaut
Autoriser plusieurs abonnements	Les clients peuvent détenir plusieurs abonnements actifs en même temps	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 leurs propres abonnements depuis le Customer Portal	Activé
Autoriser la mise en pause d’abonnement	Les clients peuvent mettre en pause et reprendre leurs propres abonnements depuis le Customer Portal	Désactivé
Facturer l’utilisation lors de la mise en pause	Un abonnement basé sur l’utilisation mis en pause est facturé pour l’utilisation due au moment de sa mise en pause, au lieu de reporter cette utilisation à la prochaine facture régulière	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.

« Allow Subscription Pause » s’applique uniquement au Customer Portal : vous pouvez mettre en pause et reprendre depuis le tableau de bord ou l’API, quel que soit son paramétrage. « Bill Usage at Pause » s’applique uniquement aux abonnements basés sur l’utilisation et est enregistré par cycle de facturation ; sa modification en cours de cycle ne change donc pas le règlement du cycle en cours. Consultez Mise en pause et reprise des abonnements.

Pour plus d’informations sur la façon 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.

Gestion des collections

Les Product Collections 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 et la mise à jour des collections, l’importation d’images, l’archivage, ainsi que la gestion des groupes et produits imbriqués.

Opérations depuis le 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 : Effectuer un glisser-déposer pour modifier l’ordre d’affichage des produits
Activer/Désactiver les produits : Contrôler les produits qui apparaissent lors du checkout
Archiver : Masquer une collection sans la supprimer définitivement (elle peut être désarchivée ultérieurement)

Capture d’écran du tableau de bord Product Collection montrant 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 les Product Collections par programmation, notamment de gérer les groupes imbriqués et les produits qu’ils contiennent.

Listing Product Collections

Récupérez toutes les Product Collections 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 Product Collection 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 Product Collection 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 Product Collection (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échargeant via une URL pré-signée. Demandez une URL d’importation à l’endpoint /product-collections/{id}/images, puis PUT l’image vers l’URL renvoyée dans un délai de 60 secondes.

L’URL pré-signée expire au bout de 60 secondes ; l’image doit donc être importé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}. Cela masque la collection pour les nouvelles utilisations, sans la supprimer 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, « Monthly Plans » et « Annual Plans »). Utilisez les endpoints des groupes pour ajouter, mettre à jour ou supprimer des groupes dans 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 Product Collection.

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 (starter/pro/enterprise)
Définir l’ordre de manière 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
Activer les deux directions : Autorisez les mises à niveau et les rétrogradations afin d’offrir plus de flexibilité aux clients
Prendre en compte la proratisation : Choisissez un mode de proratisation adapté à votre modèle économique
Tester rigoureusement : Vérifiez les parcours de checkout et de changement de plan en mode test avant la mise en production

Vous êtes prêt à créer des Product Collections et à proposer aux clients une expérience unifiée de sélection de plans.

Products

Créez des produits ponctuels, par abonnement ou basés sur l’utilisation à 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 de la 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