Product Collections

Product Collections let you group related products (e.g., Starter, Pro, Enterprise plans) under one umbrella. Display all options in a single checkout, define upgrade/downgrade paths, and give customers the flexibility to switch plans directly from the Customer Portal.

Screenshot der Produktkollektion-Kassenseite, die mehrere angezeigte Produkte zeigt

Key Highlights

Collection-based structure: Group related products (plans, tiers, pricing options) under a single collection for organized management.
One collection, many products: Include multiple products like Starter, Pro, Lifetime, etc., each with its own pricing model.
Dynamic checkout experience: Display all products from a collection in one checkout view, letting customers choose their preferred plan.
Merchant-level control: Enable, disable, and reorder products within each collection. The first product is automatically pre-selected at checkout.
Lifecycle awareness: Enable customers to upgrade or downgrade between products in the same collection via the Customer Portal.

Creating a Product Collection

Product Collections are created and managed from the dashboard or via API. Each collection acts as a container for related products.

Create the collection

Define the collection with a name and optional description. Upload an image to visually represent the collection in checkout.

Screenshot des Formulars zur Erstellung der Produktkollektion im Dashboard, das Felder für Name, Beschreibung und Bildupload zeigt

Collection fields:

Name (required): Display name for the collection (e.g., “SaaS Plans”, “License Tiers”)
Description (optional): Brief explanation shown in checkout
Image (optional): Visual branding for the collection

Add products to the collection

Add existing products to your collection. Products can be organized into groups for better structure.

Screenshot der Produktseite der Produktkollektion, die eine Liste von Produkten zeigt und die Möglichkeit, diese zur Kollektion hinzuzufügen

Product organization:

Groups: Optionally organize products into named groups (e.g., “Monthly Plans”, “Annual Plans”)
Ungrouped products: Products without a group appear at the collection level
Ordering: Drag and drop to set the display order

Each product can only belong to one collection. If a product is already in another collection, you’ll need to remove it first.

Configure ordering and visibility

Control the display order and visibility of products within the collection.Configuration options:

Product status: Enable or disable individual products within the collection
Display order: Drag and drop to set the sequence products appear in checkout

The first product in the collection is automatically pre-selected as the default at checkout. Reorder products to change which one is selected by default.

Collection Checkout

Collections enable a unified checkout experience where customers can view and select from all available products in one place.

Checkout Types

Type	Description	Use Case
Collection Checkout	Displays all active products within a collection	Subscription plan selection, tiered pricing
Single Product Checkout	Displays only one specific product	Direct purchase, promotional links

Collection Checkout Experience

When using a collection checkout:

All active products displayed: Customers see every enabled product in the collection
First product pre-selected: The first product in the collection order is automatically selected
Product details shown: Each product displays its name, description, and pricing
Single selection: Customer selects one product to purchase
Standard flow continues: After selection, the checkout proceeds with the chosen product’s pricing and billing settings

Collection checkout is ideal for subscription businesses where you want customers to compare plans side-by-side before purchasing.

API Integration

Create a checkout session for a 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;

When using product_collection_id, discount codes cannot be applied at session creation. Customers can still enter discount codes during checkout if enabled.

Customer Portal Integration

Customers can upgrade or downgrade between products within the same collection directly from the Customer Portal.

Already have subscription products? Simply add them to a Product Collection to enable upgrade/downgrade flows in the Customer Portal. No need to recreate your products.

Plan Management Actions

Action	Description	Merchant Control
View Current Plan	Display current product name, price, and renewal date	Always available
Upgrade Plan	Move to a higher-tier product in the same collection	Configurable (default: allowed)
Downgrade Plan	Move to a lower-tier product in the same collection	Configurable (default: allowed)
Cancel	Cancel the subscription entirely	Always available

Screenshot der Planänderungsschnittstelle im Kundenportal der Produktkollektion, die die Planverwaltungsaktionen zeigt

Upgrade/Downgrade Rules

Upgrades and downgrades are only available between products within the same collection
Proration is applied based on your subscription settings
Email notifications are sent to the business on every upgrade, downgrade, or cancellation

Customers cannot change to products outside their current collection. Create separate collections for distinct product lines.

Subscription Settings

Konfigurieren Sie, wie Abonnements und Planänderungen in Ihrem Unternehmen funktionieren, von Einstellungen → Abonnements in Ihrem Dashboard aus.

Screenshot der Seite mit den Abonnementeinstellungen, die Umschalter für Mehrere Abonnements zulassen und Abonnement-Aktualisierungen zulassen anzeigt

Available Settings

Einstellung	Beschreibung	Standard
Mehrere Abonnements zulassen	Kunden können gleichzeitig mehr als ein aktives Abonnement haben	Aktiviert
Aktualisierungen von Abonnements zulassen	Kunden können ihre bestehenden Abonnements jederzeit über das Customer Portal upgraden oder downgraden	Deaktiviert
Kündigung von Abonnements zulassen	Kunden können ihre eigenen Abonnements über das Customer Portal kündigen	Aktiviert
Missbrauch von Testzeiträumen verhindern	Kunden, die bereits einen Testzeitraum eingelöst haben, erhalten stattdessen einen kostenpflichtigen Kauf ohne Testzeitraum	Deaktiviert

Planänderungen über das Kundenportal sind standardmäßig deaktiviert. Aktivieren Sie “Abonnement-Aktualisierungen zulassen” in Einstellungen → Abonnements, um Kunden das Upgrade oder Downgrade zwischen Produkten in derselben Kollektion zu ermöglichen.

Wenn Sie „Allow Subscription Cancellation“ deaktivieren, wird die Self-Service-Kündigung für Kunden ausgeblendet und über die Customer Portal API gestellte Kündigungsanfragen werden abgelehnt. Ihre eigenen Kündigungen auf Händlerseite sind davon nicht betroffen. Weitere Informationen finden Sie unter Kündigen eines Abonnements.

Details dazu, wie Einlösungen von Testzeiträumen abgeglichen und aufgezeichnet werden, finden Sie unter Missbrauch von Testzeiträumen verhindern.

Subscription Plan Changes

Erfahren Sie mehr über Prorationsmodi und das Verhalten bei Planänderungen.

Sammlungen verwalten

Product Collections können entweder über das Dodo Payments-Dashboard oder programmgesteuert über die API verwaltet werden. Die API bietet vollständige Kontrolle über das Erstellen und Aktualisieren von Sammlungen, das Hochladen von Bildern, das Archivieren sowie die Verwaltung verschachtelter Gruppen und Produkte.

Dashboard-Operationen

Erstellen: Neue Sammlungen mit Produkten und Gruppen einrichten
Aktualisieren: Name, Beschreibung, Bild und Produktorganisation ändern
Neu anordnen: Die Anzeigereihenfolge der Produkte per Drag-and-drop ändern
Produkte aktivieren/deaktivieren: Steuern, welche Produkte im Checkout angezeigt werden
Archivieren: Eine Sammlung ausblenden, ohne sie dauerhaft zu löschen (sie kann später wieder aus dem Archiv entfernt werden)

Screenshot des Product-Collection-Dashboards mit den Verwaltungsoperationen für Sammlungen

API-Verwaltung

Mit den folgenden Endpoints können Sie Product Collections programmgesteuert erstellen, aktualisieren, abrufen, archivieren und organisieren – einschließlich der Verwaltung verschachtelter Gruppen und der darin enthaltenen Produkte.

Listing Product Collections

Rufen Sie alle mit Ihrem Konto verknüpften Product Collections mit einer GET-Anfrage am /product-collections-Endpoint ab. Unterstützt Pagination, die Filterung nach Marke und das Einbeziehen archivierter Sammlungen.

List Product Collections API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der API-Dokumentation zu „List Product Collections“.

Creating a Product Collection

Erstellen Sie eine neue Product Collection, indem Sie eine POST-Anfrage an den /product-collections-Endpoint senden und dabei Angaben wie Name, Beschreibung und Marke übermitteln.

Create Product Collection API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der API-Dokumentation zu „Create Product Collection“.

Retrieving a Product Collection

Rufen Sie detaillierte Informationen zu einer bestimmten Product Collection – einschließlich ihrer Gruppen und Produktelemente – mit einer GET-Anfrage am /product-collections/{id}-Endpoint ab.

Get Product Collection API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der API-Dokumentation zu „Get Product Collection“.

Updating a Product Collection

Ändern Sie die Details einer Product Collection (Name, Beschreibung, Marke usw.), indem Sie eine PATCH-Anfrage an den /product-collections/{id}-Endpoint senden.

Update Product Collection API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der API-Dokumentation zu „Update Product Collection“.

Uploading Collection Images

Verknüpfen Sie ein Bild mit einer Sammlung, indem Sie es über eine vorab signierte URL hochladen. Fordern Sie am /product-collections/{id}/images-Endpoint eine Upload-URL an und PUT Sie das Bild anschließend innerhalb von 60 Sekunden an die zurückgegebene URL.

Die vorab signierte URL läuft nach 60 Sekunden ab. Daher muss das Bild innerhalb dieses Zeitraums hochgeladen werden.

Update Collection Images API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der API-Dokumentation zu „Update Collection Images“.

Archiving a Product Collection

Archivieren Sie eine Sammlung, indem Sie eine DELETE-Anfrage an den /product-collections/{id}-Endpoint senden. Dadurch wird die Sammlung für neue Verwendungen ausgeblendet, aber nicht dauerhaft entfernt.

Archive Product Collection API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der API-Dokumentation zu „Archive Product Collection“.

Unarchiving a Product Collection

Stellen Sie eine archivierte Sammlung wieder her, indem Sie eine POST-Anfrage an den /product-collections/{id}/unarchive-Endpoint senden.

Unarchive Product Collection API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der API-Dokumentation zu „Unarchive Product Collection“.

Managing Groups within a Collection

Mit Gruppen können Sie Produkte innerhalb einer Sammlung organisieren (z. B. „Monatliche Pläne“ im Gegensatz zu „Jährliche Pläne“). Verwenden Sie die Gruppen-Endpoints, um Gruppen innerhalb einer Sammlung hinzuzufügen, zu aktualisieren oder zu entfernen.

Gruppe erstellen: POST /product-collections/{id}/groups
Gruppe aktualisieren: PATCH /product-collections/{id}/groups/{group_id}
Gruppe löschen: DELETE /product-collections/{id}/groups/{group_id}

Create Group

Fügen Sie einer Product Collection eine neue Gruppe hinzu.

Update Group

Ändern Sie den Namen oder die Attribute einer Gruppe.

Delete Group

Entfernen Sie eine Gruppe aus einer Sammlung.

Managing Products within a Group

Verwalten Sie die einzelnen Produktelemente innerhalb einer Gruppe – fügen Sie neue Produkte hinzu, aktualisieren Sie bestehende Elemente (z. B. die Anzeigereihenfolge) oder entfernen Sie sie vollständig.

Produkte zu einer Gruppe hinzufügen: POST /product-collections/{id}/groups/{group_id}/items
Gruppenelement aktualisieren: PATCH /product-collections/{id}/groups/{group_id}/items/{item_id}
Gruppenelement löschen: DELETE /product-collections/{id}/groups/{group_id}/items/{item_id}

Add Products to Group

Fügen Sie einer Gruppe innerhalb einer Sammlung ein oder mehrere Produkte hinzu.

Update Group Item

Aktualisieren Sie ein Produktelement innerhalb einer Gruppe.

Delete Group Item

Entfernen Sie ein Produktelement aus einer Gruppe.

Best Practices

Logisch gruppieren: Organisieren Sie Produkte nach Abrechnungsintervall (monatlich/jährlich) oder Funktionsstufe (Starter/Pro/Enterprise)
Strategisch anordnen: Platzieren Sie den beliebtesten oder empfohlenen Plan an erster Stelle, da er beim Checkout vorausgewählt wird
Klar benennen: Produktnamen sollten Unterschiede beim Wert klar vermitteln
Beide Richtungen aktivieren: Erlauben Sie sowohl Upgrades als auch Downgrades, um Kunden Flexibilität zu bieten
Proration berücksichtigen: Wählen Sie einen Prorationsmodus, der zu Ihrem Geschäftsmodell passt
Gründlich testen: Überprüfen Sie Checkout- und Planänderungsabläufe im Testmodus, bevor Sie live gehen

Sie können jetzt Product Collections erstellen und Kunden ein einheitliches Erlebnis bei der Planauswahl bieten.

Products

Erstellen Sie einmalige, abonnementbasierte oder nutzungsbasierte Produkte, die Sie zu Sammlungen hinzufügen können.

Checkout

Zeigen Sie Produkte einer Sammlung in einem einheitlichen Checkout-Erlebnis an.

Customer Portal

Ermöglichen Sie Kunden, innerhalb derselben Sammlung Upgrades oder Downgrades durchzuführen.

Subscriptions

Verwalten Sie wiederkehrende Pläne mit Proration und Planänderungen.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Key Highlights

Creating a Product Collection