Collezioni di Prodotti

Le Collezioni di Prodotti ti consentono di raggruppare prodotti correlati (ad esempio i piani Starter, Pro, Enterprise) sotto un unico ombrello. Mostra tutte le opzioni in un unico checkout, definisci percorsi di upgrade/downgrade e offri ai clienti la flessibilità di cambiare piano direttamente dal Portale Cliente.

Schermata della pagina di checkout della Collezione di Prodotti che mostra più prodotti visualizzati

Punti Salienti

Struttura basata su collezioni: Raggruppa prodotti correlati (piani, livelli, opzioni di prezzo) sotto un’unica collezione per una gestione organizzata.
Una collezione, molti prodotti: Includi più prodotti come Starter, Pro, Lifetime, ecc., ciascuno con il proprio modello di pricing.
Esperienza di checkout dinamica: Mostra tutti i prodotti di una collezione in un’unica vista di checkout, consentendo ai clienti di scegliere il piano preferito.
Controllo a livello di mercante: Abilita, disabilita e riordina prodotti all’interno di ciascuna collezione. Il primo prodotto è automaticamente pre-selezionato al checkout.
Consapevolezza del ciclo di vita: Permetti ai clienti di aggiornare o diminuire tra i prodotti nella stessa collezione tramite il Portale Clienti.

Creare una Collezione di Prodotti

Le Collezioni di Prodotti vengono create e gestite dal dashboard o tramite API. Ogni collezione funge da contenitore per prodotti correlati.

Create the collection

Definisci la collezione con un nome e una descrizione facoltativa. Carica un’immagine per rappresentare visivamente la collezione nel checkout.

Schermata del modulo di creazione della Collezione di Prodotti nel dashboard con campi per nome, descrizione e caricamento immagine

Campi della collezione:

Nome (obbligatorio): Nome visualizzato per la collezione (ad es. “Piani SaaS”, “Livelli di Licenza”)
Descrizione (opzionale): Breve spiegazione mostrata nel checkout
Immagine (opzionale): Branding visivo per la collezione

Add products to the collection

Aggiungi prodotti esistenti alla tua collezione. I prodotti possono essere organizzati in gruppi per una struttura migliore.

Schermata della pagina dei prodotti della Collezione di Prodotti che mostra un elenco di prodotti e la possibilità di aggiungerli alla collezione

Organizzazione dei prodotti:

Gruppi: Organizza opzionalmente i prodotti in gruppi nominati (ad es. “Piani Mensili”, “Piani Annuali”)
Prodotti non raggruppati: I prodotti senza un gruppo appaiono a livello di collezione.
Ordinamento: Trascina e rilascia per impostare l’ordine di visualizzazione.

Ogni prodotto può appartenere a una sola collezione. Se un prodotto è già in un’altra collezione, dovrai prima rimuoverlo.

Configure ordering and visibility

Controlla l’ordine di visualizzazione e la visibilità dei prodotti all’interno della collezione.Opzioni di configurazione:

Stato del prodotto: Abilita o disabilita singoli prodotti all’interno della collezione
Ordine di visualizzazione: Trascina e rilascia per impostare la sequenza in cui i prodotti appaiono nel checkout

Il primo prodotto della collezione viene automaticamente pre-selezionato come predefinito al checkout. Riorganizza i prodotti per cambiare quello selezionato di default.

Checkout della Collezione

Le collezioni abilitano un’esperienza di checkout unificata dove i clienti possono visualizzare e selezionare tutti i prodotti disponibili in un unico luogo.

Tipi di Checkout

Tipo	Descrizione	Caso d’uso
Checkout Collezione	Mostra tutti i prodotti attivi all’interno di una collezione	Selezione del piano di abbonamento, prezzi a livelli
Checkout Prodotto Singolo	Mostra solo un prodotto specifico	Acquisto diretto, link promozionali

Esperienza di Checkout della Collezione

Quando si utilizza un checkout della collezione:

Tutti i prodotti attivi mostrati: I clienti vedono ogni prodotto abilitato nella collezione
Primo prodotto pre-selezionato: Il primo prodotto nell’ordine di collezione è automaticamente selezionato
Dettagli del prodotto mostrati: Ogni prodotto mostra il proprio nome, descrizione e prezzo
Selezione singola: Il cliente seleziona un prodotto da acquistare
Flusso standard continua: Dopo la selezione, il checkout procede con la tarifazion e le impostazioni di fatturazione del prodotto scelto

Il checkout per collezioni è ideale per le attività in abbonamento dove vuoi che i clienti confrontino i piani affiancati prima di acquistare.

Integrazione API

Crea una sessione di checkout per una collezione:

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.

Integrazione del Portale Clienti

I clienti possono aggiornare o diminuire tra i prodotti all’interno della stessa collezione direttamente dal Portale Clienti.

Hai già prodotti in abbonamento? Aggiungili semplicemente a una Collezione di Prodotti per attivare i flussi di upgrade/downgrade nel Portale Cliente. Non c’è bisogno di ricreare i tuoi prodotti.

Azioni di gestione del piano

Azione	Descrizione	Controllo del commerciante
Visualizza il piano attuale	Mostra il nome del prodotto corrente, il prezzo e la data di rinnovo	Sempre disponibile
Effettua un upgrade del piano	Passa a un prodotto di livello superiore nella stessa collezione	Configurabile (predefinito: consentito)
Effettua un downgrade del piano	Passa a un prodotto di livello inferiore nella stessa collezione	Configurabile (predefinito: consentito)
Annulla	Annulla completamente l’abbonamento	Sempre disponibile

Regole di upgrade/downgrade

Upgrade e downgrade sono disponibili solo tra prodotti all’interno della stessa collezione
La rateizzazione viene applicata in base alle impostazioni dell’abbonamento
Vengono inviate notifiche email all’azienda a ogni upgrade, downgrade o cancellazione

I clienti non possono passare a prodotti al di fuori della loro collezione attuale. Crea collezioni separate per linee di prodotti distinte.

Impostazioni delle sottoscrizioni

Configura il funzionamento degli abbonamenti e delle modifiche ai piani per la tua attività dalla sezione Impostazioni delle sottoscrizioni nel dashboard.

Impostazioni disponibili

Impostazione	Descrizione	Predefinito
Consenti più abbonamenti	I clienti possono avere più di un abbonamento attivo contemporaneamente	Abilitato
Consenti aggiornamenti degli abbonamenti	I clienti possono eseguire l’upgrade o il downgrade dei loro abbonamenti esistenti in qualsiasi momento tramite Customer Portal	Disabilitato
Previeni l’uso improprio delle prove	I clienti che hanno già riscattato una prova vengono indirizzati verso un acquisto a pagamento senza prova, invece di ricevere una nuova prova	Disabilitato

Le modifiche ai piani tramite il Portale Cliente sono disabilitate di default. Abilita “Consenti aggiornamenti di sottoscrizione” nelle Impostazioni delle sottoscrizioni per permettere ai clienti di upgrade o downgrade tra i prodotti della stessa collezione.

Per informazioni dettagliate su come vengono associati e registrati i riscatti delle prove, consulta Prevenzione dell’uso improprio delle prove.

Subscription Plan Changes

Scopri di più sulle modalità di proration e sul comportamento delle modifiche ai piani.

Gestione delle raccolte

Le raccolte di prodotti possono essere gestite tramite la dashboard di Dodo Payments oppure programmaticamente tramite API. L’API offre il pieno controllo sulla creazione e sull’aggiornamento delle raccolte, sul caricamento delle immagini, sull’archiviazione e sulla gestione di gruppi e prodotti nidificati.

Operazioni dalla dashboard

Crea: configura nuove raccolte con prodotti e gruppi
Aggiorna: modifica nome, descrizione, immagine e organizzazione dei prodotti
Riordina: trascina e rilascia per modificare l’ordine di visualizzazione dei prodotti
Abilita/Disabilita prodotti: controlla quali prodotti vengono visualizzati nel checkout
Archivia: nascondi una raccolta senza eliminarla definitivamente (può essere dearchiviata in seguito)

Screenshot della dashboard delle raccolte di prodotti che mostra le operazioni di gestione delle raccolte

Gestione tramite API

I seguenti endpoint consentono di creare, aggiornare, recuperare, archiviare e organizzare programmaticamente le raccolte di prodotti, inclusa la gestione dei gruppi nidificati e dei prodotti al loro interno.

Listing Product Collections

Recupera tutte le raccolte di prodotti associate al tuo account usando una richiesta GET al endpoint /product-collections. Supporta la paginazione, il filtraggio per brand e l’inclusione delle raccolte archiviate.

List Product Collections API

Consulta la struttura dettagliata delle richieste e delle risposte nella documentazione dell’API List Product Collections.

Creating a Product Collection

Crea una nuova raccolta di prodotti inviando una richiesta POST all’endpoint /product-collections con dettagli come nome, descrizione e brand.

Create Product Collection API

Consulta la struttura dettagliata delle richieste e delle risposte nella documentazione dell’API Create Product Collection.

Retrieving a Product Collection

Ottieni informazioni dettagliate su una raccolta di prodotti specifica, inclusi i relativi gruppi e prodotti, usando una richiesta GET all’endpoint /product-collections/{id}.

Get Product Collection API

Consulta la struttura dettagliata delle richieste e delle risposte nella documentazione dell’API Get Product Collection.

Updating a Product Collection

Modifica i dettagli di una raccolta di prodotti (nome, descrizione, brand e così via) inviando una richiesta PATCH all’endpoint /product-collections/{id}.

Update Product Collection API

Consulta la struttura dettagliata delle richieste e delle risposte nella documentazione dell’API Update Product Collection.

Uploading Collection Images

Associa un’immagine a una raccolta caricandola tramite un URL pre-firmato. Richiedi un URL di caricamento dall’endpoint /product-collections/{id}/images, quindi PUT l’immagine all’URL restituito entro 60 secondi.

L’URL pre-firmato scade dopo 60 secondi, quindi l’immagine deve essere caricata entro tale intervallo.

Update Collection Images API

Consulta la struttura dettagliata delle richieste e delle risposte nella documentazione dell’API Update Collection Images.

Archiving a Product Collection

Archivia una raccolta inviando una richiesta DELETE all’endpoint /product-collections/{id}. In questo modo la raccolta viene nascosta dai nuovi utilizzi, ma non viene rimossa definitivamente.

Archive Product Collection API

Consulta la struttura dettagliata delle richieste e delle risposte nella documentazione dell’API Archive Product Collection.

Unarchiving a Product Collection

Ripristina una raccolta archiviata inviando una richiesta POST all’endpoint /product-collections/{id}/unarchive.

Unarchive Product Collection API

Consulta la struttura dettagliata delle richieste e delle risposte nella documentazione dell’API Unarchive Product Collection.

Managing Groups within a Collection

I gruppi consentono di organizzare i prodotti all’interno di una raccolta (ad esempio, “Piani mensili” e “Piani annuali”). Usa gli endpoint dei gruppi per aggiungere, aggiornare o rimuovere gruppi all’interno di una raccolta.

Crea un gruppo: POST /product-collections/{id}/groups
Aggiorna un gruppo: PATCH /product-collections/{id}/groups/{group_id}
Elimina un gruppo: DELETE /product-collections/{id}/groups/{group_id}

Create Group

Aggiungi un nuovo gruppo a una raccolta di prodotti.

Update Group

Modifica il nome o gli attributi di un gruppo.

Delete Group

Rimuovi un gruppo da una raccolta.

Managing Products within a Group

Gestisci i singoli prodotti all’interno di un gruppo: aggiungi nuovi prodotti, aggiorna quelli esistenti (ad esempio l’ordine di visualizzazione) oppure rimuovili completamente.

Aggiungi prodotti a un gruppo: POST /product-collections/{id}/groups/{group_id}/items
Aggiorna un prodotto del gruppo: PATCH /product-collections/{id}/groups/{group_id}/items/{item_id}
Elimina un prodotto del gruppo: DELETE /product-collections/{id}/groups/{group_id}/items/{item_id}

Add Products to Group

Aggiungi uno o più prodotti a un gruppo all’interno di una raccolta.

Update Group Item

Aggiorna un prodotto all’interno di un gruppo.

Delete Group Item

Rimuovi un prodotto da un gruppo.

Buone pratiche

Raggruppa in modo logico: organizza i prodotti per intervallo di fatturazione (mensile/annuale) o livello di funzionalità (starter/pro/enterprise)
Ordina in modo strategico: posiziona per primo il piano più popolare o consigliato, poiché verrà preselezionato al checkout
Usa nomi chiari: i nomi dei prodotti devono comunicare chiaramente le differenze di valore
Abilita entrambe le direzioni: consenti sia gli upgrade sia i downgrade per offrire flessibilità ai clienti
Considera la proration: scegli una modalità di proration in linea con il tuo modello di business
Esegui test approfonditi: verifica i flussi di checkout e di modifica dei piani in modalità test prima del go-live

Ora puoi creare raccolte di prodotti e offrire ai clienti un’esperienza unificata di selezione dei piani.

Products

Crea prodotti una tantum, con abbonamento o basati sull’utilizzo da aggiungere alle raccolte.

Checkout

Mostra i prodotti della raccolta in un’esperienza di checkout unificata.

Customer Portal

Consenti ai clienti di eseguire l’upgrade o il downgrade all’interno della stessa raccolta.

Subscriptions

Gestisci i piani ricorrenti con proration e modifiche ai piani.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Punti Salienti

Creare una Collezione di Prodotti