Product Collections

Product Collections gruppieren verwandte Produkte (z. B. Starter-, Pro- und Enterprise-Pläne) unter einer gemeinsamen Oberkategorie. Zeigen Sie alle Optionen in einem einzigen Checkout an, definieren Sie Upgrade-/Downgrade-Pfade und ermöglichen Sie Kunden, Pläne direkt über das Customer Portal zu wechseln.

Screenshot der Produktkollektion-Kassenseite, die mehrere angezeigte Produkte zeigt

Key Highlights

Mit Product Collections können Sie:

Verwandte Produkte (Pläne, Stufen und Preisoptionen) zur übersichtlichen Verwaltung gruppieren.
Mehrere Produkte einschließen, z. B. Starter, Pro und Lifetime, jeweils mit einem eigenen Preismodell.
Alle Produkte in einer Checkout-Ansicht anzeigen, damit Kunden ihre bevorzugte Option vergleichen und auswählen können.
Kunden ermöglichen, über das Customer Portal zwischen Produkten derselben Collection up- oder downzugraden.
Steuern, welche Produkte sichtbar sind, in welcher Reihenfolge sie angezeigt werden und welches beim Checkout vorausgewählt ist.

Product Collection erstellen

Erstellen und verwalten Sie Collections über das Dashboard oder per API.

Create the collection

Definieren Sie die Collection mit einem Namen und einer optionalen Beschreibung. Laden Sie ein Bild hoch, das sie im Checkout repräsentiert.

Screenshot des Formulars zum Erstellen einer Product Collection im Dashboard mit Feldern für Name, Beschreibung und Bildupload

Collection-Felder:

Name (erforderlich): Anzeigename (z. B. „SaaS Plans“, „License Tiers“).
Beschreibung (optional): Kurze Erklärung, die im Checkout angezeigt wird.
Bild (optional): Visuelles Branding für die Collection.

Add products to the collection

Fügen Sie Ihrer Collection vorhandene Produkte hinzu. Organisieren Sie sie zur besseren Struktur in Gruppen.

Screenshot der Produktseite einer Product Collection mit einer Produktliste und der Möglichkeit, Produkte zur Collection hinzuzufügen

Produktorganisation:

Gruppen: Organisieren Sie Produkte optional in benannten Gruppen (z. B. „Monthly Plans“, „Annual Plans“).
Nicht gruppierte Produkte: Produkte ohne Gruppe werden auf Collection-Ebene angezeigt.
Reihenfolge: Legen Sie die Anzeigereihenfolge per Drag-and-drop fest.

Jedes Produkt kann nur zu einer Collection gehören. Wenn sich ein Produkt bereits in einer anderen Collection befindet, entfernen Sie es zuerst.

Configure ordering and visibility

Steuern Sie die Anzeigereihenfolge und Sichtbarkeit der Produkte innerhalb der Collection.Konfigurationsoptionen:

Produktstatus: Aktivieren oder deaktivieren Sie einzelne Produkte innerhalb der Collection.
Anzeigereihenfolge: Legen Sie per Drag-and-drop die Reihenfolge fest, in der Produkte im Checkout erscheinen.

Das erste Produkt in der Collection wird beim Checkout automatisch vorausgewählt. Ordnen Sie die Produkte neu an, um die standardmäßig ausgewählte Option zu ändern.

Collection Checkout

Collections ermöglichen ein einheitliches Checkout-Erlebnis, bei dem Kunden alle verfügbaren Produkte an einem Ort ansehen und auswählen können.

Checkout-Typen

Typ	Beschreibung	Anwendungsfall
Collection Checkout	Zeigt alle aktiven Produkte innerhalb einer Collection an	Auswahl von Abonnementplänen, gestaffelte Preise
Single Product Checkout	Zeigt nur ein bestimmtes Produkt an	Direkter Kauf, Werbelinks

Collection-Checkout-Erlebnis

Bei Verwendung eines Collection Checkouts:

Alle aktiven Produkte in der Collection werden angezeigt.
Das erste Produkt in der Reihenfolge der Collection wird automatisch vorausgewählt.
Jedes Produkt zeigt seinen Namen, seine Beschreibung und seine Preise an.
Der Kunde wählt ein Produkt zum Kauf aus.
Der Checkout wird mit den Preis- und Abrechnungseinstellungen des ausgewählten Produkts fortgesetzt.

Screenshot der Checkout-Seite einer Product Collection mit mehreren angezeigten Produkten

Der Collection Checkout eignet sich ideal für Abonnementunternehmen, deren Kunden Pläne vor dem Kauf direkt miteinander vergleichen.

API-Integration

Erstellen Sie eine Checkout-Session für eine 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'
});

window.location.href = session.checkout_url;

Bei Verwendung von product_collection_id können Rabattcodes bei der Session-Erstellung nicht vorab angewendet werden. Kunden können Codes während des Checkouts weiterhin eingeben, sofern diese Option aktiviert ist.

Customer-Portal-Integration

Kunden können direkt über das Customer Portal zwischen Produkten derselben Collection up- oder downgraden.

Sie haben bereits Abonnementprodukte? Fügen Sie sie einer Product Collection hinzu, um Upgrade-/Downgrade-Abläufe im Customer Portal zu aktivieren. Ihre Produkte müssen nicht neu erstellt werden.

Aktionen zur Planverwaltung

Aktion	Beschreibung	Händlersteuerung
Aktuellen Plan anzeigen	Zeigt den Namen, Preis und Verlängerungstermin des aktuellen Produkts an.	Immer verfügbar.
Plan upgraden	Wechsel zu einem höherstufigen Produkt in derselben Collection.	Konfigurierbar (Standard: deaktiviert).
Plan downgraden	Wechsel zu einem niedriger eingestuften Produkt in derselben Collection.	Konfigurierbar (Standard: deaktiviert).
Kündigen	Kündigt das Abonnement vollständig.	Immer verfügbar.

Upgrade-/Downgrade-Regeln

Upgrades und Downgrades sind nur zwischen Produkten innerhalb derselben Collection verfügbar.
Die Proration für Planänderungen im Customer Portal folgt dem standardmäßigen Upgrade- und Downgrade-Verhalten unter Settings → Subscriptions. Jede Collection kann diese Standardeinstellungen überschreiben. Bei Planänderungen über die Change Plan API wird der mit der Anfrage gesendete proration_billing_mode verwendet.
Bei jedem Upgrade, Downgrade oder jeder Kündigung werden E-Mail-Benachrichtigungen an das Unternehmen gesendet.

Kunden können nicht zu Produkten außerhalb ihrer aktuellen Collection wechseln. Erstellen Sie für separate Produktlinien eigene Collections.

Abonnement-Einstellungen

Konfigurieren Sie unter Settings → Subscriptions in Ihrem Dashboard, wie Abonnements und Planänderungen in Ihrem Unternehmen funktionieren.

Verfügbare Einstellungen

Einstellung	Beschreibung	Standard
Allow Multiple Subscriptions	Kunden können gleichzeitig mehr als ein aktives Abonnement haben.	Aktiviert
Allow Subscription Updates	Kunden können ihre bestehenden Abonnements jederzeit über das Customer Portal up- oder downgraden.	Deaktiviert
Allow Immediate Cancellation	Kunden können ihr Abonnement sofort beenden und verlieren unmittelbar den Zugriff.	Aktiviert
Allow Cancellation at Next Billing Date	Kunden können zum Ende des bereits bezahlten Zeitraums kündigen.	Aktiviert
Allow Subscription Pause	Kunden können ihre eigenen Abonnements über das Customer Portal pausieren und fortsetzen.	Deaktiviert
Bill Usage at Pause	Ein pausiertes nutzungsbasiertes Abonnement wird zum Zeitpunkt der Pausierung für die angefallene Nutzung in Rechnung gestellt, anstatt die Nutzung auf die nächste reguläre Rechnung zu übertragen.	Aktiviert
Prevent Trial Misuse	Kunden, die bereits eine Testphase eingelöst haben, erhalten statt einer neuen Testphase einen kostenpflichtigen Kauf ohne Testphase.	Deaktiviert
Payment Method Reminder	Anzahl der Tage vor Beginn der Abrechnung, an denen der Kunde eines Abonnements mit aktivierter Option Card-Optional at Zero Price per E-Mail aufgefordert wird, eine Zahlungsmethode hinzuzufügen (1 bis 30 Tage).	3 Tage

Planänderungen über das Customer Portal sind standardmäßig deaktiviert. Aktivieren Sie „Allow Subscription Updates“ unter Settings → Subscriptions, damit Kunden zwischen Produkten derselben Collection up- oder downgraden können.

Die beiden Kündigungseinstellungen sind unabhängig voneinander. Sie können Kunden erlauben, den bereits bezahlten Zeitraum vollständig zu nutzen, während die sofortige Kündigung nur Ihnen zur Verfügung steht – oder umgekehrt. Durch die Deaktivierung einer Option wird diese im Customer Portal ausgeblendet und entsprechende Anfragen über die Customer-Portal-API werden abgelehnt. Eigene Kündigungen auf Händlerseite sind davon nicht betroffen. Siehe Cancelling a Subscription.

„Allow Subscription Pause“ betrifft ausschließlich das Customer Portal – Sie können Abonnements unabhängig von dieser Einstellung ü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 ändert daher nicht die Abrechnung des aktuellen Zyklus. Siehe Pausing and Resuming Subscriptions.

Details dazu, wie Einlösungen von Testphasen abgeglichen und erfasst werden, finden Sie unter Preventing Trial Misuse.

„Payment Method Reminder“ ist nur für Abonnements relevant, bei denen Card-Optional at Zero Price aktiviert ist. Die Einstellung hat keine Auswirkungen auf Abonnements, für die bereits eine Karte erforderlich ist. Die vollständige Abfolge, einschließlich der Folgen einer ignorierten Erinnerung, finden Sie unter What Happens Without a Card.

Subscription Plan Changes

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

Collections verwalten

Verwalten Sie Collections über das Dashboard oder programmatisch per API.

Dashboard-Operationen

Erstellen: Richten Sie neue Collections mit Produkten und Gruppen ein.
Aktualisieren: Ändern Sie Name, Beschreibung, Bild und Produktorganisation.
Neu anordnen: Ändern Sie die Anzeigereihenfolge der Produkte per Drag-and-drop.
Produkte aktivieren/deaktivieren: Steuern Sie, welche Produkte im Checkout erscheinen.
Archivieren: Blenden Sie eine Collection aus, ohne sie dauerhaft zu löschen (sie kann später wiederhergestellt werden).

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

API-Verwaltung

Verwenden Sie die folgenden Endpunkte, um Product Collections programmatisch zu erstellen, zu aktualisieren, abzurufen, zu archivieren und zu organisieren, einschließlich der Verwaltung verschachtelter Gruppen und Produkte.

Listing Product Collections

Rufen Sie alle mit Ihrem Konto verknüpften Product Collections über eine GET-Anfrage an den Endpunkt /product-collections ab. Unterstützt werden Paginierung, Filterung nach Marke und das Einschließen archivierter Collections.

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 Produktsammlung, indem Sie eine POST-Anfrage an den /product-collections-Endpunkt mit dem erforderlichen name und groups von Produkten senden, sowie optionalen Details wie Beschreibung und Marke.

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 – über eine GET-Anfrage an den Endpunkt /product-collections/{id} 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 Endpunkt /product-collections/{id} 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 Collection, indem Sie es über eine vorab signierte URL hochladen. Fordern Sie eine Upload-URL beim Endpunkt /product-collections/{id}/images an und PUT Sie 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 Collection, indem Sie eine DELETE-Anfrage an den Endpunkt /product-collections/{id} senden. Dadurch wird die Collection 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 Collection wieder her, indem Sie eine POST-Anfrage an den Endpunkt /product-collections/{id}/unarchive 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 Collection organisieren (z. B. „Monthly Plans“ und „Annual Plans“). Verwenden Sie die Gruppen-Endpunkte, um Gruppen innerhalb einer Collection 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 Collection.

Managing Products within a Group

Verwalten Sie die einzelnen Produktelemente innerhalb einer Gruppe – fügen Sie neue Produkte hinzu, aktualisieren Sie vorhandene 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 Collection 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.
Eindeutig benennen: Produktnamen sollten Unterschiede beim Mehrwert 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.

Products

Erstelle einmalige, abonnementsbasierte oder nutzungsbasierte Produkte, die du zu Collections hinzufügen kannst.

Checkout

Zeige Produkte einer Collection in einer einheitlichen Checkout-Erfahrung an.

Customer Portal

Ermögliche Kunden, innerhalb derselben Collection Upgrades oder Downgrades vorzunehmen.

Subscriptions

Verwalte wiederkehrende Pläne mit Proration und Planänderungen.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Key Highlights

Product Collection erstellen