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

Aktion	Beschreibung	Händlersteuerung
Aktuellen Plan anzeigen	Aktuellen Produktnamen, Preis und Verlängerungsdatum anzeigen	Immer verfügbar
Plan upgraden	Zu einem Produkt einer höheren Stufe innerhalb derselben Sammlung wechseln	Konfigurierbar (Standard: deaktiviert)
Plan downgraden	Zu einem Produkt einer niedrigeren Stufe innerhalb derselben Sammlung wechseln	Konfigurierbar (Standard: deaktiviert)
Kündigen	Das Abonnement vollständig kündigen	Immer verfügbar

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
Pausieren von Abonnements zulassen	Kunden können ihre eigenen Abonnements über das Customer Portal pausieren und fortsetzen	Deaktiviert
Nutzung bei Pausierung abrechnen	Ein pausiertes nutzungsbasiertes Abonnement wird zum Zeitpunkt der Pausierung für die geschuldete Nutzung in Rechnung gestellt, anstatt die Nutzung auf die nächste reguläre Rechnung zu übertragen	Aktiviert
Missbrauch von Testzeiträumen verhindern	Kunden, die bereits einen Testzeitraum eingelöst haben, erhalten einen kostenpflichtigen Kauf ohne Testzeitraum, anstatt einen neuen Testzeitraum zu erhalten	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.

„Allow Subscription Pause“ gilt ausschließlich für das Customer Portal – unabhängig von dieser Einstellung können Sie Abonnements über das Dashboard oder die API pausieren und fortsetzen. „Bill Usage at Pause“ gilt nur für nutzungsbasierte Abonnements und wird pro Abrechnungszyklus erfasst. Eine Änderung während eines laufenden Zyklus wirkt sich daher nicht darauf aus, wie der aktuelle Zyklus abgerechnet wird. Siehe Abonnements pausieren und fortsetzen.

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

Subscription Plan Changes

Erfahren Sie mehr über Proration-Modi und das Verhalten bei Planänderungen.

Sammlungen verwalten

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

Dashboard-Operationen

Erstellen: Neue Sammlungen mit Produkten und Gruppen einrichten
Aktualisieren: Namen, 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 wiederhergestellt 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 mit einer GET-Anfrage an den /product-collections-Endpoint alle mit Ihrem Konto verknüpften Product Collections ab. Unterstützt Pagination, Filterung nach Marke und das Einschließen 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 mit einer GET-Anfrage an den /product-collections/{id}-Endpoint detaillierte Informationen zu einer bestimmten Product Collection ab – einschließlich ihrer Gruppen und Produkteinträge.

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 über den /product-collections/{id}/images-Endpoint eine Upload-URL an und PUT anschließend das Bild innerhalb von 60 Sekunden an die zurückgegebene URL.

Die vorab signierte URL läuft nach 60 Sekunden ab. Das Bild muss daher 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

Gruppen ermöglichen es Ihnen, Produkte innerhalb einer Sammlung zu organisieren (z. B. „Monatliche Pläne“ und „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 Produkteinträge innerhalb einer Gruppe – fügen Sie neue Produkte hinzu, aktualisieren Sie bestehende Einträge (z. B. die Anzeigereihenfolge) oder entfernen Sie sie vollständig.

Produkte zu einer Gruppe hinzufügen: POST /product-collections/{id}/groups/{group_id}/items
Gruppeneintrag aktualisieren: PATCH /product-collections/{id}/groups/{group_id}/items/{item_id}
Gruppeneintrag 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 einen Produkteintrag innerhalb einer Gruppe.

Delete Group Item

Entfernen Sie einen Produkteintrag 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
Eindeutige Namen verwenden: Produktnamen sollten Unterschiede beim Leistungsumfang 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 Proration-Modus, 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 eine einheitliche Auswahl von Plänen anbieten.

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