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 of the Product Collection checkout page showing multiple products displayed

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 of the Product Collection creation form in the dashboard showing fields for name, description, and image upload

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 of the Product Collection products page showing a list of products and the ability to add them to the collection

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

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

Configure how subscriptions and plan changes work across your business from the Subscription Settings section in your dashboard.

Available Settings

Setting	Description	Default
Tillåt flera prenumerationer	Kunder kan ha mer än en aktiv prenumeration samtidigt	Aktiverad
Tillåt uppdateringar av prenumerationer	Kunder kan när som helst uppgradera eller nedgradera sina befintliga prenumerationer via Customer Portal	Inaktiverad
Tillåt uppsägning av prenumerationer	Kunder kan säga upp sina egna prenumerationer från Customer Portal	Aktiverad
Förhindra missbruk av provperioder	Kunder som redan har använt en provperiod får i stället ett betalt köp utan provperiod, i stället för att få en ny provperiod	Inaktiverad

Plan changes via Customer Portal are disabled by default. Enable “Allow Subscription Updates” in your Subscription Settings to let customers upgrade or downgrade between products in the same collection.

Om du inaktiverar “Tillåt uppsägning av prenumerationer” döljs möjligheten för kunder att själva säga upp prenumerationer, och uppsägningsbegäranden via Customer Portal API avvisas. Egna uppsägningar från merchantsidan påverkas inte. Se Säga upp en prenumeration.

Mer information om hur användning av provperioder matchas och registreras finns i Förhindra missbruk av provperioder.

Subscription Plan Changes

Läs mer om prorateringslägen och hur planändringar fungerar.

Hantera samlingar

Product Collections kan hanteras antingen via Dodo Payments-dashboarden eller programmatiskt via API. API:et ger full kontroll över skapande och uppdatering av samlingar, bilduppladdningar, arkivering samt hantering av kapslade grupper och produkter.

Åtgärder i dashboarden

Skapa: Konfigurera nya samlingar med produkter och grupper
Uppdatera: Ändra namn, beskrivning, bild och produktorganisation
Ändra ordning: Dra och släpp för att ändra visningsordningen för produkter
Aktivera/inaktivera produkter: Styr vilka produkter som visas i checkout
Arkivera: Dölj en samling utan att ta bort den permanent (den kan avarkiveras senare)

Skärmbild av Product Collection-dashboarden som visar åtgärder för hantering av samlingar

API-hantering

Följande endpoints låter dig skapa, uppdatera, hämta, arkivera och organisera Product Collections programmatiskt — inklusive hantering av kapslade grupper och produkterna i dem.

Listing Product Collections

Hämta alla Product Collections som är kopplade till ditt konto med en GET-begäran till endpointen /product-collections. Stöder paginering, filtrering efter varumärke och inkludering av arkiverade samlingar.

List Product Collections API

Se detaljerad struktur för request och response i API-dokumentationen för List Product Collections.

Creating a Product Collection

Skapa en ny Product Collection genom att skicka en POST-begäran till endpointen /product-collections med uppgifter som namn, beskrivning och varumärke.

Create Product Collection API

Se detaljerad struktur för request och response i API-dokumentationen för Create Product Collection.

Retrieving a Product Collection

Hämta detaljerad information om en specifik Product Collection — inklusive dess grupper och produktobjekt — med en GET-begäran till endpointen /product-collections/{id}.

Get Product Collection API

Se detaljerad struktur för request och response i API-dokumentationen för Get Product Collection.

Updating a Product Collection

Ändra uppgifterna för en Product Collection (namn, beskrivning, varumärke med mera) genom att skicka en PATCH-begäran till endpointen /product-collections/{id}.

Update Product Collection API

Se detaljerad struktur för request och response i API-dokumentationen för Update Product Collection.

Uploading Collection Images

Koppla en bild till en samling genom att ladda upp den via en försignerad URL. Begär en uppladdnings-URL från endpointen /product-collections/{id}/images och PUT sedan upp bilden till den returnerade URL:en inom 60 sekunder.

Den försignerade URL:en upphör att gälla efter 60 sekunder, så bilden måste laddas upp inom den tidsramen.

Update Collection Images API

Se detaljerad struktur för request och response i API-dokumentationen för Update Collection Images.

Archiving a Product Collection

Arkivera en samling genom att skicka en DELETE-begäran till endpointen /product-collections/{id}. Detta döljer samlingen från ny användning men tar inte bort den permanent.

Archive Product Collection API

Se detaljerad struktur för request och response i API-dokumentationen för Archive Product Collection.

Unarchiving a Product Collection

Återställ en arkiverad samling genom att skicka en POST-begäran till endpointen /product-collections/{id}/unarchive.

Unarchive Product Collection API

Se detaljerad struktur för request och response i API-dokumentationen för Unarchive Product Collection.

Managing Groups within a Collection

Grupper låter dig organisera produkter i en samling (till exempel “Månadsplaner” jämfört med “Årsplaner”). Använd group-endpoints för att lägga till, uppdatera eller ta bort grupper i en samling.

Skapa en grupp: POST /product-collections/{id}/groups
Uppdatera en grupp: PATCH /product-collections/{id}/groups/{group_id}
Ta bort en grupp: DELETE /product-collections/{id}/groups/{group_id}

Create Group

Lägg till en ny grupp i en Product Collection.

Update Group

Ändra en grupps namn eller attribut.

Delete Group

Ta bort en grupp från en samling.

Managing Products within a Group

Hantera de enskilda produkterna i en grupp — lägg till nya produkter, uppdatera befintliga objekt (till exempel visningsordning) eller ta bort dem helt.

Lägg till produkter i en grupp: POST /product-collections/{id}/groups/{group_id}/items
Uppdatera ett gruppobjekt: PATCH /product-collections/{id}/groups/{group_id}/items/{item_id}
Ta bort ett gruppobjekt: DELETE /product-collections/{id}/groups/{group_id}/items/{item_id}

Add Products to Group

Lägg till en eller flera produkter i en grupp i en samling.

Update Group Item

Uppdatera ett produktobjekt i en grupp.

Delete Group Item

Ta bort ett produktobjekt från en grupp.

Bästa praxis

Gruppera logiskt: Organisera produkter efter faktureringsintervall (månatligt/årligt) eller funktionsnivå (starter/pro/enterprise)
Ordna strategiskt: Placera den populäraste eller rekommenderade planen först, eftersom den väljs i förväg i checkout
Använd tydliga namn: Produktnamn bör tydligt kommunicera skillnader i värde
Aktivera båda riktningarna: Tillåt både uppgraderingar och nedgraderingar för att ge kunderna flexibilitet
Ta hänsyn till proratering: Välj ett prorateringsläge som passar din affärsmodell
Testa noggrant: Verifiera flöden för checkout och planändringar i testläge innan du går live

Du är redo att skapa Product Collections och ge kunderna en enhetlig upplevelse för att välja plan.

Products

Skapa engångsprodukter, prenumerationsprodukter eller användningsbaserade produkter som kan läggas till i samlingar.

Checkout

Visa produkter från samlingar i en enhetlig checkout-upplevelse.

Customer Portal

Låt kunder uppgradera eller nedgradera inom samma samling.

Subscriptions

Hantera återkommande planer med proratering och planändringar.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Key Highlights

Creating a Product Collection